Skip to content

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)"

方法二:官方安装包

  1. 访问 nodejs.org/zh-cn/download
  2. 下载 macOS 的 LTS 版本(.pkg 文件)
  3. 双击运行安装包,按向导完成安装

方法三: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

下一步

✅ 环境准备完成!

和谐、友善、互助、开心