跳到主要内容

macOS 平台

macOS 推荐使用本站的一键脚本安装 Node.js v22 LTS。脚本会优先使用 Homebrew 或 nvm，不会配置 Claude、Codex 或任何 API Key。

推荐：一键安装​

在 Terminal 中执行：

curl -fsSL https://docs.muskapi.cc/scripts/install-node.sh | bash

或：

wget -qO- https://docs.muskapi.cc/scripts/install-node.sh | bash

如果你在国内网络环境下安装较慢，脚本默认会提示是否使用国内镜像。也可以显式指定：

INSTALL_MIRROR=cn curl -fsSL https://docs.muskapi.cc/scripts/install-node.sh | bash

安装完成后重新打开 Terminal，再检查版本：

node -v
npm -v
npx -v

node -v 显示 22 或更高版本即可。

备用：官方安装包​

  1. 打开 Node.js 官网。
  2. 下载 macOS LTS 安装包。
  3. 按提示安装。
  4. 重新打开终端。
  5. 检查版本。
node -v
npm -v
npx -v

node -v 显示 22 或更高版本即可。

备用：Homebrew​

已经安装 Homebrew 的用户可以执行：

brew install node
node -v
npm -v

如果之前安装过旧版 Node.js，可以先执行：

brew update
brew upgrade node

备用：nvm​

需要在多个项目之间切换 Node.js 版本时，建议使用 nvm：

nvm install 22
nvm use 22
node -v

如果终端提示找不到 nvm，说明 nvm 尚未安装或 shell 配置未加载。

终端和权限​

  • 默认 zsh 用户通常修改 ~/.zshrc。
  • bash 用户通常修改 ~/.bashrc 或 ~/.bash_profile。
  • 不建议使用 sudo npm install -g 安装普通客户端工具，避免权限和路径混乱。
  • 如果命令安装后找不到，检查当前终端的 PATH。