Mac + nvm：程序员必须掌握的 Node 版本管理神技
从 Windows 平滑过渡到 Mac，第一件事就是配置开发环境。在 Windows 时我就习惯了用 nvm 管理 Node.js 版本，来到 Mac 后发现很多人居然还在用brew install node装一个版本死磕，或者手动卸载重装…太折腾了！
其实 Mac 上 nvm 用起来更丝滑。今天把这套Mac M4（Apple Silicon）标准 Node 多版本管理方案分享给大家，让 Windows 用户无缝切换，一步到位告别版本混乱。
一、为什么需要 nvm？
想象一下这些场景：
场景 1：老项目用的是 Node 14，新项目要求 Node 20，你怎么同时开发？
场景 2：全局安装了一个版本的 Node，结果某个依赖包死活不兼容，想降级却发现不知道怎么卸载？
场景 3：团队成员用不同 Node 版本，CI 环境又是另一个版本，偶现的 bug 真让人头秃？
nvm 就是来救你的：
✅多版本共存：想装几个装几个
✅秒级切换：一条命令搞定
✅项目隔离：不同项目自动用不同版本
✅零侵入：不污染系统环境
二、安装前准备
确保你已经安装了 Homebrew。在终端执行：
brew --version如果输出了版本号，恭喜你可以继续了。如果没有，请先安装 Homebrew：
/bin/bash -c"$(curl-fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"三、通过 Homebrew 安装 nvm
第一步：安装 nvm
brewinstallnvm等待安装完成…
第二步：创建 nvm 目录（重要！）
这个目录用来存放不同版本的 Node.js：
mkdir-p ~/.nvm第三步：配置 Shell 环境
Mac M4 默认使用 zsh，我们需要编辑~/.zshrc文件：
nano~/.zshrc在文件末尾添加以下内容（复制粘贴即可）：
# NVM 配置exportNVM_DIR="$HOME/.nvm"[-s"$(brew --prefix nvm)/nvm.sh"]&&\."$(brew --prefix nvm)/nvm.sh"[-s"$(brew --prefix nvm)/etc/bash_completion.d/nvm"]&&\."$(brew --prefix nvm)/etc/bash_completion.d/nvm"保存后按Ctrl + O，回车确认，然后Ctrl + X退出。
最后让配置生效：
source~/.zshrc第四步：验证安装
nvm -v如果输出了版本号（比如0.40.0），说明安装成功！
四、安装 Node.js 版本
查看所有可用版本
nvm ls-remote输出会很长，从最早的版本到最新的都有…
只看 LTS 版本（推荐）
LTS（Long Term Support）是长期支持版本，稳定可靠：
nvm ls-remote --lts安装最新 LTS 版本
nvminstall--lts安装指定版本
比如安装 Node 18、20、22 三个主流版本：
nvminstall18nvminstall20nvminstall22或者安装精确版本：
nvminstall20.11.1推荐策略：安装三个版本覆盖大部分场景
- Node 18：维护老项目
- Node 20：主流稳定开发
- Node 22：新项目尝鲜
五、查看和切换版本
查看已安装的版本
nvmls示例输出：
-> v20.11.1 v18.19.0 v22.0.0 default -> 20 system箭头->表示当前正在使用的版本。
切换版本
临时切换（当前终端有效）：
nvm use18切换到最新 LTS：
nvm use --lts设置默认版本
这样每次打开新终端都会自动使用这个版本：
nvmaliasdefault20查看当前版本
node-v或者：
nvm current六、项目级自动切换（高级技巧）
这是我最喜欢的功能！
在项目根目录创建.nvmrc文件：
echo"24.13.1">.nvmrc以后每次进入这个项目，只需要执行：
nvm use就会自动切换到 Node 20！
团队协作神器：把.nvmrc提交到 Git，团队成员 clone 项目后执行nvm use，保证大家 Node 版本一致！
七、卸载 Node 版本
比如要卸载 Node 18：
nvm uninstall18或者卸载精确版本：
nvm uninstall18.19.0八、Apple Silicon（M4）特别说明
M4 芯片是 ARM 架构，不用担心！nvm 会自动识别并安装darwin-arm64版本。
验证一下：
node-p process.arch应该输出：
arm64不需要 Rosetta 转译，原生性能满血运行！
九、避坑指南（非常重要！）
❌ 不要混用包管理器
如果你用了 nvm，就不要再执行：
brewinstallnode这会导致冲突！检查一下你的 Node 来自哪里：
whichnode正确输出应该是：
~/.nvm/versions/node/v20.11.1/bin/node错误输出（说明混用了）：
/opt/homebrew/bin/node如果发现混用了，卸载 brew 安装的版本：
brew uninstallnode✅ 推荐做法
只用 nvm 管理 Node，Homebrew 只用来安装 nvm。
十、常用命令速查表
| 功能 | 命令 |
|---|---|
| 查看所有可安装版本 | nvm ls-remote |
| 只看 LTS 版本 | nvm ls-remote --lts |
| 安装最新 LTS | nvm install --lts |
| 安装指定版本 | nvm install 20 |
| 查看已安装版本 | nvm ls |
| 切换版本 | nvm use 20 |
| 设置默认版本 | nvm alias default 20 |
| 卸载版本 | nvm uninstall 18 |
| 查看当前版本 | node -v或nvm current |
十一、完整配置示例
一套完整的配置流程，复制粘贴即可：
# 1. 安装 nvmbrewinstallnvm# 2. 创建目录mkdir-p ~/.nvm# 3. 配置环境（手动编辑 ~/.zshrc，添加前文提到的配置）# 然后执行：source~/.zshrc# 4. 安装三个常用版本nvminstall18nvminstall20nvminstall22# 5. 设置默认版本nvmaliasdefault20# 6. 验证node-v nvmls十二、总结
配置完成后的结构是这样的：
Mac M4 └─ Homebrew └─ nvm ├─ Node 18（老项目） ├─ Node 20（默认，主力开发） └─ Node 22（新项目）这套方案的优势：
✅清晰隔离：每个 Node 版本独立管理
✅随时切换：秒级响应，无感知切换
✅团队协作：.nvmrc保证版本一致
✅原生支持：M4 芯片 ARM64 完美运行
✅可逆操作：随时卸载，不留痕迹
以后再也不会因为 Node 版本问题浪费时间了。
如果你觉得这篇文章有帮助，欢迎关注公众号 FishTech Notes，一块交流使用心得！