必须用nvm解决:它在用户目录隔离多版本Node,一条命令切换,避免重装、PATH冲突和全局包污染。

Mac上需要同时维护Node 16的老项目和Node 20的新服务,但系统里只装了一个Node版本,每次切项目都得重装或改PATH,终端报错不断,全局包还互相污染——这种情况必须用nvm解决,它能把多个Node版本干净地隔离在用户目录下,切换只要一条命令。
卸载残留Node并确认Shell类型
先打开终端,执行node -v和which node。如果返回版本号且路径含/usr/local/bin或/opt/homebrew,说明之前用Homebrew或pkg装过,必须卸载干净:运行brew uninstall node(Homebrew安装)或前往官网下载对应pkg双击卸载(pkg安装)。接着确认当前shell:echo $SHELL,输出/bin/zsh则后续操作针对~/.zshrc;若为/bin/bash则对应~/.bash_profile。
【不卸载旧Node直接装nvm会导致PATH冲突,node命令可能仍指向旧版本】
安装nvm并加载到终端环境
方法一:官方脚本安装(推荐)
在终端中粘贴执行:curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash。脚本会自动尝试写入~/.zshrc(或对应shell配置文件),但国内网络常失败,需手动补全。
方法二:Homebrew安装(仅限明确偏好brew管理的用户)
先确保已装Homebrew:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)";再执行:brew install nvm。注意:Homebrew安装的nvm路径是/usr/local/opt/nvm,与官方脚本路径不同,后续初始化语句要严格匹配。
无论哪种方式,都必须向shell配置文件追加两行:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
然后执行source ~/.zshrc(或对应文件)使配置生效。
配置国内镜像源加速下载
第一步:设置Node.js二进制镜像
nvm node_mirror https://npmmirror.com/mirrors/node/
第二步:设置npm包管理器镜像
nvm npm_mirror https://npmmirror.com/mirrors/npm/
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
第三步:验证是否生效
nvm get mirror应同时输出两个https://npmmirror.com开头的地址。这一步不做的话,nvm install大概率卡在99%,等十分钟没反应是常态。
安装并切换多个Node.js版本
① 查看所有可安装版本:nvm list-remote
② 安装长期支持版(LTS):nvm install --lts(当前为20.18.0)
③ 安装最新稳定版:nvm install 24.16.0
④ 安装指定旧版(如遗留项目需要):nvm install 16.20.2
⑤ 切换到Node 24:nvm use 24 → 此时node -v输出v24.16.0,npm -v输出对应版本
这一步操作起来很简单,直接输入命令回车就行。但要注意:【nvm use只对当前终端会话生效,新开终端需重新执行,或设为default】
设置默认版本与项目级自动切换
让每次新打开的终端自动使用Node 24:nvm alias default 24。此后所有新终端启动即激活该版本,无需重复nvm use。
进入某个老项目目录后自动切到Node 16:
在项目根目录创建文件:echo "16.20.2" > .nvmrc
然后执行:nvm use(无参数)→ 终端将读取.nvmrc并自动切换
这功能依赖nvm shell函数已正确加载,如果执行nvm use报错“command not found”,说明前几步的source没成功,需检查.zshrc内容和source命令是否执行。










