适用人群：
- macOS 用户（Intel / M1 / M2 / M3 都适用）
- 前端 / Node / 全栈 / Java 开发
- 不想把环境搞乱的新手
如果你刚开始在 MacBook 上学习开发，Node.js 基本是必装的 。
但很多人一上来就踩坑，比如：
- 用 Homebrew 装 Node，结果版本乱
- 想切 Node 版本，却发现根本切不了
- 全局包冲突，
node -v和npm -v对不上
👉 正确姿势只有一个：先装 nvm，再用 nvm 管理 Node。
这篇文章带你从 0 到 1，一次装对，不返工。
一、先搞清楚：nvm 是什么？为什么一定要用？
1️⃣ Node.js 是什么？
- Node.js 是一个 JavaScript 运行环境
- 前端工程（Vue / React / Vite / Next.js）几乎都离不开它
2️⃣ nvm 是什么？
nvm = Node Version Manager（Node 版本管理工具）
它可以帮你：
- 同时安装多个 Node 版本（14 / 16 / 18 / 20）
- 不同项目用不同 Node
- 随时切换，不破坏系统环境
👉 结论一句话：Mac 上千万不要只装一个裸 Node，一定要用 nvm。
二、macOS 安装 nvm（官方推荐方式）
⚠️ 注意：
不推荐用 Homebrew 安装 nvmnvm 本质是 shell 脚本，Homebrew 反而容易把环境搞复杂。
✅ 正确方式：官方脚本安装
1️⃣ 打开终端（Terminal）
快捷键：
Command + 空格 → 输入 Terminal → 回车2️⃣ 执行安装命令
复制下面这行，直接粘贴回车：
bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash等待执行完成。
3️⃣ 配置环境变量（非常重要）
macOS 默认使用 zsh ，配置文件是 ~/.zshrc
执行：
bash
nano ~/.zshrc确认里面有下面内容（没有就加上）：
bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"保存并退出（Ctrl + O → 回车 → Ctrl + X）
让配置立即生效：
bash
source ~/.zshrc4️⃣ 验证 nvm 是否安装成功
bash
nvm -v如果能看到版本号，例如：
0.39.7✅ 说明 nvm 安装成功
三、用 nvm 安装 Node.js（推荐版本）
1️⃣ 查看可安装的 Node 版本
bash
nvm ls-remote你会看到很多版本，不用纠结。
2️⃣ 推荐安装哪个版本？
- 新手 / 前端 / 后端通用：Node 18 或 20（LTS）
- 示例：安装 Node 18
bash
nvm install 183️⃣ 使用该版本
bash
nvm use 18验证：
bash
node -v
npm -v看到正常版本号即可。
四、设置默认 Node 版本（强烈建议）
否则每次开新终端都要 nvm use。
bash
nvm alias default 18以后：
- 新开终端
- Node 自动就是 18
五、每个项目使用不同 Node（进阶但很实用）
方式一：手动切换
bash
nvm use 16方式二（推荐）：使用 .nvmrc
在项目根目录创建文件：
.nvmrc内容写：
18以后进入项目目录：
bash
nvm use自动切版本。
六、常见错误和避坑指南（必看）
❌ 1️⃣ 不要同时用 Homebrew 装 Node
如果你之前执行过：
bash
brew install node建议卸载：
bash
brew uninstall node否则会出现：
node -v和which node对不上- npm 全局包混乱
❌ 2️⃣ 不要把 nvm 写到多个配置文件
- macOS 默认只用：
~/.zshrc - 不要同时写
.bashrc、.bash_profile
❌ 3️⃣ 终端里提示 nvm: command not found
说明：
.zshrc没加载- 或者没
source ~/.zshrc
七、总结（直接记住这几条）
✅ MacBook 安装 Node 的正确流程是：
- 官方脚本安装 nvm
- 用 nvm 安装 Node
- 设置默认 Node 版本
- 不用 Homebrew 装 Node
一次配置好，以后几年都不用折腾。