安装

Deno 是一个单一二进制可执行文件，没有外部依赖。它可运行于 macOS、Linux 和 Windows，并支持 x64 和 arm64 架构。

下载和安装 Jump to heading#

deno_install 提供了方便的脚本来下载和安装二进制文件。

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

npm install -g deno

nix-shell -p deno

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

npm install -g deno

brew install deno

sudo port install deno

nix-shell -p deno

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

npm install -g deno

scoop install deno

choco install deno

winget install DenoLand.Deno

Deno 不发布官方 apt 仓库，而 Linux 发行版（如 Debian、Ubuntu、Arch 或 Snap Store）打包的版本由社区维护，通常会落后于最新发布版本。要在任何 Linux 发行版上获得最新版本，请使用上面的 shell 安装程序（或 手动下载），它始终会安装当前发布版本。

跨平台包管理器 Jump to heading#

这些版本管理器可在 macOS、Linux 和 Windows 上运行。

使用 asdf:

asdf plugin add deno https://github.com/asdf-community/asdf-deno.git

# 下载并安装 Deno 的最新版本
asdf install deno latest

# 将其设置为全局默认的 Deno 版本
asdf set -u deno latest

# 将其设置为本地（仅当前项目）的默认 Deno 版本
asdf set deno latest

使用 vfox:

vfox add deno

# 下载并安装 Deno 的最新版本
vfox install deno@latest

# 将 Deno 的版本设置为全局
vfox use --global deno

你也可以使用 Cargo 从源代码构建并安装：

cargo install deno --locked

手动下载 Jump to heading#

Deno 二进制文件也可以手动安装，只需从 github.com/denoland/deno/releases 下载 zip 文件。 每个发布版本都会为每个平台提供一个归档文件，其中包含一个可执行文件：

解压归档文件，并将 deno 可执行文件放到 PATH 中的某个位置。你 需要在 macOS 和 Linux 上设置可执行位。每个资源都有一个 匹配的 .sha256sum 文件用于验证下载。

在 Linux 上，常见的选择是 ~/.local/bin（按用户）或 /usr/local/bin （系统范围）。例如：

unzip deno-x86_64-unknown-linux-gnu.zip
mkdir -p ~/.local/bin
mv deno ~/.local/bin/
chmod +x ~/.local/bin/deno
# 确保该目录已加入你的 PATH，然后进行验证
deno --version

Docker Jump to heading#

Deno 会在 Docker Hub 和 GitHub Container Registry 上发布官方镜像，提供 debian、ubuntu、alpine、distroless 和 bin 变体。

有关 Dockerfile、多阶段构建、Docker Compose 以及其他最佳实践，请参见 Deno 和 Docker。

安装位置 Jump to heading#

二进制文件位置 Jump to heading#

当通过 shell 或 PowerShell 脚本安装时，deno 二进制文件会被放置在以下默认位置：

在运行安装脚本之前设置 DENO_INSTALL 环境变量，可以覆盖安装目录。

当通过包管理器（Homebrew、Scoop 等）安装时，二进制文件位置由该包管理器管理。

缓存位置 Jump to heading#

下载的依赖和编译后的制品会存储在 Deno 的缓存目录中。其默认路径取决于平台：

通过设置 DENO_DIR 环境变量可以覆盖它（参见 环境变量）。运行 deno info 可 打印当前正在使用的目录。

测试你的安装 Jump to heading#

要测试您的安装，运行 deno --version。如果在控制台打印 Deno 版本，则表示安装成功。

使用 deno help 查看记录 Deno 标志和用法的帮助文本。有关每个子命令的指南，请参见 CLI 参考。

如果您看到“command not found” Jump to heading#

如果 deno --version 报告 command not found，说明安装目录还不在 您的 PATH 中。要修复此问题：

• 打开一个新的终端窗口，或者重新启动您的 shell，以便加载更新后的 PATH。 这是最常见的原因——安装脚本会更新您的 shell rc 文件，但现有的 shell 会话在重新加载之前不会看到更改。
• 确认安装目录在您的 PATH 中。shell 安装脚本在 macOS 和 Linux 上默认使用 ~/.deno/bin；对于基于 npm 的安装，运行 npm config get prefix 以找到包含全局 bin 的目录。
• 如果您自定义了安装位置，可以使用 DENO_INSTALL 环境变量覆盖 shell 安装脚本的 安装根目录，此时二进制文件位于 $DENO_INSTALL/bin/deno。

更新 Jump to heading#

要更新之前安装的 Deno 版本，您可以运行：

deno upgrade

或使用 Homebrew（macOS）：

brew upgrade deno

或使用 Scoop（Windows）：

scoop update deno

或使用 Chocolatey（Windows）：

choco upgrade deno

或使用 Winget（Windows）：

winget upgrade DenoLand.Deno

这将从 github.com/denoland/deno/releases 获取最新版本，解压缩并用其替换您当前的可执行文件。

您也可以使用此工具安装特定版本的 Deno：

deno upgrade --version 2.7.0

卸载 Jump to heading#

如果您使用 shell 或 PowerShell 安装脚本安装了 Deno，请先清除 Deno 缓存目录（$DENO_DIR）：

deno clean

然后删除 Deno 的安装目录：

rm -rf ~/.deno

Remove-Item -Recurse -Force "$env:USERPROFILE\.deno"

如果您是通过包管理器（Homebrew、Scoop、Chocolatey 等）安装的 Deno， 请改用该包管理器的卸载命令（例如 brew uninstall deno、scoop uninstall deno）。

从源代码构建 Jump to heading#

有关如何从源代码构建的信息可以在 从源代码构建 指南中找到。