Skip to content

Node.js macOS 安装

macOS 上最省心的方式是用 Homebrew,如果你不想装 Homebrew,也可以直接下官方 PKG 安装包。

方法 A:Homebrew(推荐)

先确认 Homebrew 有没有装:

bash
brew -v

能看到版本号就跳到下一步。没有的话,用官方安装脚本装一下:

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

Homebrew 准备好之后,装 Node.js:

bash
brew update
brew install node

验证版本:

bash
node -v
npm -v

只要能看到版本号就 OK。

方法 B:官网 PKG 安装包

更直观、不依赖 Homebrew:

  1. 访问 nodejs.org
  2. 下载 LTS 版的 macOS Installer(.pkg
  3. 双击打开,跟着图形化向导点下去
  4. 装完后打开终端,跑 node -v 验证

常见问题

1)npm install -g 报权限错误

默认情况下 Homebrew 装的 Node.js 会把全局包装到 Homebrew 自己的目录里,不需要 sudo。如果你看到 EACCES 或者要你写 /usr/local 的错误,多半是系统里混了一个早期用 pkg 装的 node。建议卸掉旧的,全部交给 Homebrew 管理。

另一个干净的做法是装 nvm(Node Version Manager),所有 Node 版本都放在 ~/.nvm 下,天然不会有权限问题。

2)npm 下载慢

切到国内镜像:

bash
npm config set registry https://registry.npmmirror.com
npm config get registry

配置会写到 ~/.npmrc,持久生效。想恢复官方源就改回 https://registry.npmjs.org

3)brew install node 装的是最新版,我想要 LTS

可以显式指定版本号,例如:

bash
brew install node@22

然后按 brew 提示把这个版本链接到 PATH 即可。

AI通道 · 让国内开发者直连全球 AI 模型