推荐用Homebrew一键安装Node.js和npm,自动适配Apple Silicon与Intel芯片,并永久配置淘宝npmmirror源(https://registry.npmmirror.com)加速下载,同时修复全局权限问题确保npm install -g无报错。

在Mac上完成Node.js和npm的安装并配置国内淘宝npmmirror源,是前端开发环境搭建的第一步。如果你刚拿到一台新Mac,或者重装系统后需要重建开发环境,这一步必须准确执行,否则后续所有npm install都会卡在超时或404错误上。
用Homebrew一键安装Node.js和npm
这是目前最推荐的方式——它自动处理路径、权限、更新与卸载,且适配Apple Silicon(M1/M2/M3)和Intel芯片。Homebrew会把node和npm二进制文件软链到/opt/homebrew/bin(Apple Silicon)或/usr/local/bin(Intel),并确保新开终端也能识别命令。
第一步:安装Homebrew(如尚未安装)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
第二步:执行安装
brew install node
第三步:验证是否可用
node -v → 输出类似 v20.11.1
npm -v → 输出类似 10.2.4
【若任一命令报 command not found,请先关闭终端再重新打开,不要跳过这步】
第四步:确认可执行文件位置
which node → 应返回 /opt/homebrew/bin/node 或 /usr/local/bin/node
which npm → 同理应指向对应路径
永久配置npm使用淘宝npmmirror源
npm默认从美国服务器下载包,国内直连极慢甚至失败。淘宝npmmirror(现由 npmmirror.com 运营)是当前最稳定、同步及时的国内镜像,已全面替代旧的 taobao.org 域名。
方法一:一行命令永久设置(推荐)
npm config set registry https://registry.npmmirror.com
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
方法二:手动编辑 .npmrc 文件(适合项目级隔离)
echo "registry=https://registry.npmmirror.com" >> ~/.npmrc
验证是否生效:
npm config get registry → 必须返回 https://registry.npmmirror.com
【注意:不要用 sudo 执行 npm config set,否则配置会写入 root 用户目录,普通用户终端无法读取】
解决全局包安装权限问题(关键补丁)
Homebrew安装的Node.js默认允许无sudo安装全局包,但部分用户因历史残留配置或手动改过prefix,仍可能遇到 EACCES: permission denied 错误。此时需重置npm全局路径到用户目录。
① 创建专属全局目录
mkdir ~/.npm-global
② 告诉npm使用该目录
npm config set prefix ~/.npm-global
③ 将该目录下的bin加入PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
④ 验证新路径生效
npm config get prefix → 返回 /Users/你的用户名/.npm-global
npm install -g http-server → 不再报EACCES即成功


















