Deno在macOS上安装失败的常见原因包括脚本未执行、环境变量未配置或Shell类型识别错误；推荐使用官方install.sh脚本，按zsh配置PATH后source生效，再通过deno --version验证。

如果您在 macOS 系统上尝试安装 Deno 运行时，但执行命令后提示 deno 命令未找到或安装失败，则可能是由于安装脚本未正确执行、环境变量未配置或 Shell 配置文件类型识别错误。以下是多种可靠且经验证的安装方法：

一、使用官方安装脚本（推荐）

该方式直接调用 Deno 官方维护的 install.sh 脚本，自动下载指定版本二进制并放置到 ~/.deno/bin 目录，适用于绝大多数 macOS 用户。

1、打开终端，执行标准安装命令：
curl -fsSL https://deno.land/x/install/install.sh | sh

2、检查安装输出，确认提示中显示 ~/.deno/bin 已创建，并记录提示中的 PATH 配置语句。

3、根据您当前使用的 Shell 类型，将 deno 二进制路径添加至对应配置文件：
若使用 zsh（macOS Catalina 及之后默认）：运行 echo $SHELL，如输出 /bin/zsh，则执行 vim ~/.zshrc，在末尾添加：
export DENO_INSTALL="$HOME/.deno"
export PATH="$DENO_INSTALL/bin:$PATH"

4、使配置生效：
source ~/.zshrc

5、验证安装：
deno --version

若成功返回类似 deno 1.42.0 (release, aarch64-apple-darwin) 的输出，则表示安装完成。

二、指定版本安装（稳定可控）

避免因网络波动或最新版存在兼容性问题导致安装中断，可显式指定已验证稳定的 Deno 版本（如 v1.41.3），确保二进制一致性与可复现性。

1、执行带版本参数的安装命令：
curl -fsSL https://deno.land/x/install/install.sh | sh -s v1.41.3

2、确认 ~/.deno/bin/deno 文件存在且具有可执行权限：
ls -l ~/.deno/bin/deno

3、按前述步骤将 ~/.deno/bin 加入 PATH，并 source 对应 Shell 配置文件。

4、运行 deno --version，检查输出是否匹配指定版本：
v1.41.3 必须完整出现在版本字符串中。

三、通过 Homebrew 安装（适合已有 Homebrew 生态的用户）

Homebrew 提供了包签名验证与依赖管理能力，适合偏好统一包管理流程的开发者，尤其适用于 M1/M2/M3 芯片 Mac 的原生适配场景。

1、确保已安装 Homebrew：
which brew || /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2、更新 Homebrew 并安装 Deno：
brew update && brew install deno

3、Homebrew 会自动将 deno 符号链接至 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel），该路径通常已在 PATH 中。

4、验证安装：
deno --version

若输出中包含 homebrew 或路径显示为 /opt/homebrew/bin/deno，则表明为 Homebrew 渠道安装。

四、手动下载并配置（离线或调试场景）

当网络策略限制脚本执行、或需审计二进制来源时，可手动下载官方发布包，校验 SHA256 后解压部署，完全掌控安装链路。

1、访问 https://github.com/denoland/deno/releases，找到最新 release 的 darwin-aarch64.tar.gz（M系列芯片）或 darwin-x86_64.tar.gz（Intel 芯片）文件。

2、下载后校验完整性：
shasum -a 256 deno-x.x.x-darwin-aarch64.zip

3、解压并移动二进制到安全位置：
tar -xzf deno-x.x.x-darwin-aarch64.tar.gz
sudo mv deno /usr/local/bin/

4、赋予执行权限：
sudo chmod +x /usr/local/bin/deno

5、验证：
deno --version

此时输出应不含 ~/.deno 字样，而是直接来自 /usr/local/bin/deno，权限由 sudo 显式授予，无环境变量依赖。

五、验证 Deno 运行能力（基础功能测试）

安装完成后需确认 Deno 不仅能响应命令，还能正确解析、编译并执行 TypeScript 与远程模块，以排除沙箱或权限配置异常。

1、创建测试文件 hello.ts：
echo 'console.log("Hello from Deno!");' > hello.ts

2、运行本地 TypeScript 文件：
deno run hello.ts

3、执行远程模块（首次会下载并缓存）：
deno run https://deno.land/std@0.224.0/examples/welcome.ts

4、若第二步输出 Hello from Deno!，第三步输出欢迎信息且无 PermissionDenied 错误，则 Deno 运行时已就绪。