macOS 平台安装 Node.js
CodeX、Gemini CLI 等工具均需要 Node.js 环境。请按以下步骤在 macOS 系统上安装。
方法一:Homebrew 安装(推荐)
如果您已安装 Homebrew,可以直接运行:
bash
brew install node或安装 LTS 版本:
bash
brew install node@20如果尚未安装 Homebrew,先执行:
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"方法二:官方安装包
- 访问 nodejs.org/zh-cn/download
- 下载 macOS 的 LTS 版本(
.pkg文件) - 双击运行安装包,按向导完成安装
方法三:nvm(版本管理器)
使用 nvm 可以方便地管理多个 Node.js 版本:
bash
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重启终端后安装 LTS 版本
nvm install --lts
nvm use --lts验证安装
打开终端,执行:
bash
node --version
npm --version如果显示版本号(如 v20.x.x),说明安装成功。
常见问题
提示"command not found: node"
- 确认 PATH 中包含 Node.js 路径(通常
/usr/local/bin或/opt/homebrew/bin) - 重新打开终端窗口
- 如使用 Homebrew,执行
brew link node
权限问题
- 避免使用
sudo npm install -g安装全局包 - 推荐使用 nvm 管理 Node.js,无需 sudo
下一步
✅ 环境准备完成!