Mac配置Node.js环境需两步:一是将Node二进制目录(如/usr/local/bin)加入PATH(编辑~/.zshrc并source生效),确保node -v和npm -v可用;二是重设npm全局路径至~/.npm-global并将其bin加入PATH,避免EACCES权限错误,再配置国内镜像源加速安装。Mac 上配置 Node.js 环境变量和全局目录,核心是两件事:让系统能找到 `node` 和 `npm` 命令(环境变量 PATH),以及让 `npm install -g` 安装的工具(比如 `vue`, `pnpm`, `typescript`)能被直接调用且不报权限错误(自定义全局路径)。这两步缺一不可,否则常遇到 “command not found” 或 “EACCES: permission denied”。
确认 Node.js 已安装并定位可执行文件
先打开终端,运行:
node -v 和 npm -v
如果输出版本号,说明已安装;如果提示 command not found,说明 PATH 未包含 Node 的二进制目录。
用以下命令查 Node 实际位置:
which node
常见路径有:/usr/local/bin/node(Homebrew 或 pkg 安装)、~/.nvm/versions/node/vxx.x.x/bin/node(nvm 安装)、或 /opt/homebrew/bin/node(Apple Silicon 上新版 Homebrew)。记下这个路径的父目录(比如 /usr/local/bin),后面要加到 PATH。
把 Node 可执行目录加入 PATH(环境变量)
Mac 默认使用 zsh,配置文件是 ~/.zshrc。编辑它:
nano ~/.zshrc
在文件末尾添加一行(把 /your/node/bin/path 替换为你上一步查到的实际路径,例如 /usr/local/bin):
export PATH="/your/node/bin/path:$PATH"
保存退出(Ctrl+O → Enter → Ctrl+X),然后立即生效:
source ~/.zshrc
验证是否成功:
echo $PATH —— 看输出里是否含你刚加的路径
node -v && npm -v —— 应该能正常显示版本
重设 npm 全局安装路径(避开 sudo 和权限问题)
默认全局路径(如 /usr/local/lib/node_modules)需要管理员权限,不安全也不便管理。推荐改到用户目录下:
- 创建新目录:mkdir ~/.npm-global
- 告诉 npm 使用它:npm config set prefix ~/.npm-global
- 把该目录下的 bin 加入 PATH(仍在
~/.zshrc中追加):
export PATH=~/.npm-global/bin:$PATH - 重新加载:source ~/.zshrc
验证设置是否生效:
npm config get prefix → 应输出 /Users/你的用户名/.npm-global
npm config get cache → 默认缓存会自动放在子目录,无需额外设置
可选但强烈建议:换国内镜像源加速
npm 默认源在国外,安装慢还容易失败。执行:
npm config set registry https://registry.npmmirror.com
验证:
npm config get registry → 应返回 https://registry.npmmirror.com
这样后续 npm install -g @vue/cli 或 npm install -g pnpm 就能快速完成,且命令可直接在终端任意位置调用。


















