macOS 平台安装 Node.js

本文介绍如何在 macOS 系统上安装 Node.js 运行环境。推荐使用 Homebrew 进行安装，操作最为简便。

方式一：使用 Homebrew 安装（推荐）

如果你还没有安装 Homebrew，请先在终端中运行以下命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Homebrew 安装完成后，运行以下命令安装 Node.js：

brew install node

Homebrew 会自动下载并安装 Node.js 和 npm。安装完成后，进行版本验证。

验证安装

node -v

你应该会看到类似 `v20.x.x` 的输出。

npm -v

npm 版本应显示为 10.x.x 或更高。

[截图：brew install node 的执行输出]

💡 提示 Homebrew 会自动将 Node.js 添加到你的 PATH 中，无需额外配置。

方式二：下载官方安装包

如果你不想使用 Homebrew，也可以直接从官网下载：

• 访问 https://nodejs.org/

• 点击 LTS 版本按钮下载 .pkg 安装包

• 双击 .pkg 文件，按照安装向导提示完成安装

• 安装过程中保持默认选项即可，系统会自动配置 PATH

验证安装

打开终端（Terminal.app），运行：

node -v

npm -v

如果能看到版本号，说明安装成功。

[截图：终端中 node -v 和 npm -v 的输出]

方式三：使用 nvm 安装（高级用户）

如果你需要同时管理多个 Node.js 版本，推荐使用 nvm（Node Version Manager）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

安装 nvm 后，重新打开终端或运行：

source ~/.zshrc

然后安装 Node.js：

nvm install --lts

nvm 会自动安装最新的 LTS 版本并将其设为默认版本。

**💡 提示** nvm 的优势在于可以随时切换不同版本的 Node.js。如果你的项目需要特定版本，nvm 是最佳选择。

## 常见问题

### 权限错误 EACCES
如果在使用 npm 安装全局包时遇到权限错误，请检查当前用户对 `/usr/local/lib/node_modules` 的写入权限，或考虑使用 nvm 来避免权限问题。

### Apple Silicon (M1/M2/M3) 芯片兼容性
Homebrew 官方包和 Node.js 官网安装包均原生支持 Apple Silicon 芯片，无需额外配置。

### 终端无法识别 node 命令
如果你是通过安装包安装的，尝试关闭终端并重新打开。如果使用的是 zsh，运行：

source ~/.zshrc

🚀 下一步 Node.js 安装完成后，你可以前往「Linux 平台」了解其他系统的安装方式，或直接前往「CC-Switch」工具页面进行快速配置。