安装与配置 #

一、安装概述 #

Deno是一个单一的可执行文件，安装过程简单快捷。本章将介绍在各种操作系统上安装Deno的方法。

二、系统要求 #

2.1 支持的操作系统 #

操作系统	架构	支持状态
macOS	x64, ARM64	完全支持
Windows	x64	完全支持
Linux	x64, ARM64	完全支持

2.2 依赖项 #

Deno几乎没有外部依赖：

macOS 10.15+ (Catalina)
Windows 10+ 或 Windows Server 2016+
Linux (glibc 2.17+)

三、安装方法 #

3.1 macOS/Linux安装 #

使用Shell安装（推荐）：

bash

curl -fsSL https://deno.land/install.sh | sh

使用Homebrew安装：

bash

brew install deno

使用Scoop安装：

bash

scoop install deno

3.2 Windows安装 #

使用PowerShell安装（推荐）：

powershell

irm https://deno.land/install.ps1 | iex

使用Chocolatey安装：

powershell

choco install deno

使用Scoop安装：

powershell

scoop install deno

3.3 使用包管理器安装 #

Cargo (Rust包管理器)：

bash

cargo install deno

Nix：

bash

nix-env -i deno

3.4 手动安装 #

从GitHub Releases下载：

访问 https://github.com/denoland/deno/releases
下载对应平台的压缩包
解压并将可执行文件移动到PATH目录

bash

# macOS/Linux
sudo mv deno /usr/local/bin/

# Windows (以管理员身份运行)
move deno.exe C:\Windows\System32\

四、验证安装 #

4.1 检查版本 #

bash

deno --version

输出示例：

text

deno 2.0.0 (release, aarch64-apple-darwin)
v8 12.1.285.6
typescript 5.3.3

4.2 运行测试 #

bash

deno eval "console.log('Hello, Deno!')"

输出：

text

Hello, Deno!

五、环境配置 #

5.1 环境变量 #

Deno使用以下环境变量：

变量名	说明	默认值
DENO_DIR	缓存目录	~/.cache/deno
DENO_INSTALL_ROOT	安装目录	~/.deno/bin
DENO_NO_UPDATE_CHECK	禁用更新检查	-
NO_COLOR	禁用颜色输出	-

5.2 配置PATH #

安装后，确保Deno在PATH中：

macOS/Linux (Bash)：

bash

echo 'export DENO_INSTALL="/Users/用户名/.deno"' >> ~/.bashrc
echo 'export PATH="$DENO_INSTALL/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

macOS/Linux (Zsh)：

bash

echo 'export DENO_INSTALL="/Users/用户名/.deno"' >> ~/.zshrc
echo 'export PATH="$DENO_INSTALL/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Windows：

将安装目录添加到系统PATH环境变量。

5.3 Shell补全 #

安装Shell补全脚本：

bash

# Bash
deno completions bash > ~/.deno/completions/deno.bash
echo 'source ~/.deno/completions/deno.bash' >> ~/.bashrc

# Zsh
deno completions zsh > ~/.zsh/completion/_deno

# Fish
deno completions fish > ~/.config/fish/completions/deno.fish

# PowerShell
deno completions powershell >> $PROFILE

六、版本管理 #

6.1 升级Deno #

内置升级命令：

bash

# 升级到最新版本
deno upgrade

# 升级到指定版本
deno upgrade 2.0.0

# 升级到特定发布通道
deno upgrade --canary
deno upgrade --rc

6.2 使用版本管理器 #

dvm (Deno Version Manager)：

bash

# 安装dvm
curl -fsSL https://dvm.deno.dev | sh

# 安装特定版本
dvm install 2.0.0

# 切换版本
dvm use 2.0.0

# 列出已安装版本
dvm list

# 列出可用版本
dvm ls-remote

asdf：

bash

# 安装deno插件
asdf plugin add deno

# 安装特定版本
asdf install deno 2.0.0

# 设置全局版本
asdf global deno 2.0.0

# 设置本地版本
asdf local deno 2.0.0

七、IDE配置 #

7.1 VS Code #

安装Deno扩展：

打开VS Code扩展面板
搜索 “Deno”
安装由Deno Land Inc.发布的官方扩展

配置 .vscode/settings.json：

json

{
  "deno.enable": true,
  "deno.lint": true,
  "deno.unstable": false,
  "deno.importMap": "./import_map.json"
}

7.2 JetBrains IDE #

IntelliJ IDEA、WebStorm等：

安装Deno插件
配置Deno可执行文件路径
启用Deno支持

7.3 Vim/Neovim #

使用vim-plug安装：

vim

Plug 'vim-denops/denops.vim'
Plug 'vim-denops/denops-helloworld.vim'

或使用LSP配置：

lua

-- nvim-lspconfig
require'lspconfig'.denols.setup{}

八、项目初始化 #

8.1 创建项目 #

bash

# 创建项目目录
mkdir my-deno-project
cd my-deno-project

# 初始化配置文件
deno init

生成的文件结构：

text

my-deno-project/
├── deno.json       # 项目配置
├── main.ts         # 主入口文件
├── main_test.ts    # 测试文件
└── lib/
    └── util.ts

8.2 deno.json配置 #

json

{
  "name": "@my-org/my-project",
  "version": "1.0.0",
  "tasks": {
    "dev": "deno run --watch main.ts",
    "test": "deno test --allow-all",
    "build": "deno compile --output my-app main.ts"
  },
  "imports": {
    "@std/http": "jsr:@std/http@^1.0.0"
  },
  "compilerOptions": {
    "strict": true
  },
  "fmt": {
    "useTabs": false,
    "lineWidth": 80,
    "indentWidth": 2,
    "semiColons": true
  },
  "lint": {
    "rules": {
      "exclude": ["no-explicit-any"]
    }
  }
}

九、缓存管理 #

9.1 缓存目录 #

Deno将依赖缓存到：

macOS/Linux: ~/.cache/deno
Windows: %LOCALAPPDATA%\deno

9.2 缓存命令 #

bash

# 缓存依赖
deno cache script.ts

# 重新加载所有依赖
deno cache --reload script.ts

# 清除缓存
deno cache --reload --lock-write script.ts

9.3 锁定文件 #

生成依赖锁定文件：

bash

deno cache --lock=deno.lock --lock-write script.ts

使用锁定文件：

bash

deno cache --lock=deno.lock script.ts

十、常见问题 #

10.1 权限问题 #

如果遇到权限错误：

bash

# macOS/Linux
chmod +x $(which deno)

# 或重新安装
curl -fsSL https://deno.land/install.sh | sh

10.2 网络问题 #

如果下载慢，可以设置代理：

bash

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

10.3 版本冲突 #

使用版本管理器管理多个版本：

bash

# 使用dvm
dvm install 1.40.0
dvm use 1.40.0

十一、总结 #

本章学习了：

各平台安装Deno的方法
环境变量配置
Shell补全配置
版本管理
IDE配置
项目初始化
缓存管理

下一章，我们将编写第一个Deno程序。