MacBook上安装nvm和Node.js的正确姿势(新手必看)

适用人群：

• macOS 用户（Intel / M1 / M2 / M3 都适用）
• 前端 / Node / 全栈 / Java 开发
• 不想把环境搞乱的新手

如果你刚开始在 MacBook 上学习开发，Node.js 基本是必装的。
但很多人一上来就踩坑，比如：

• 用 Homebrew 装 Node，结果版本乱
• 想切 Node 版本，却发现根本切不了
• 全局包冲突，node -v 和 npm -v 对不上

👉 正确姿势只有一个：先装 nvm，再用 nvm 管理 Node。

这篇文章带你从 0 到 1，一次装对，不返工。

一、先搞清楚：nvm 是什么？为什么一定要用？

Node.js 是什么？

• Node.js 是一个 JavaScript 运行环境
• 前端工程（Vue / React / Vite / Next.js）几乎都离不开它

nvm 是什么？

nvm = Node Version Manager（Node 版本管理工具）

它可以帮你：

• 同时安装多个 Node 版本（14 / 16 / 18 / 20）
• 不同项目用不同 Node
• 随时切换，不破坏系统环境

👉 结论一句话：Mac 上千万不要只装一个裸 Node，一定要用 nvm。

二、macOS 安装 nvm（官方推荐方式）

⚠️ 注意：
不推荐用 Homebrew 安装 nvm
nvm 本质是 shell 脚本，Homebrew 反而容易把环境搞复杂。

正确方式：官方脚本安装

打开终端（Terminal）

快捷键：

Command + 空格 → 输入 Terminal → 回车

执行安装命令

复制下面这行，直接粘贴回车：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

等待执行完成。

配置环境变量（非常重要）

macOS 默认使用 zsh，配置文件是 ~/.zshrc

执行：

nano ~/.zshrc

确认里面有下面内容（没有就加上）：

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）

让配置立即生效：

source ~/.zshrc

验证 nvm 是否安装成功

nvm -v

如果能看到版本号，例如：

0.39.7

✅ 说明 nvm 安装成功

三、用 nvm 安装 Node.js（推荐版本）

查看可安装的 Node 版本

nvm ls-remote

你会看到很多版本，不用纠结。

推荐安装哪个版本？

• 新手 / 前端 / 后端通用：Node 18 或 20（LTS）
• 示例：安装 Node 18

nvm install 18

使用该版本

nvm use 18

验证：

node -v
npm -v

看到正常版本号即可。

四、设置默认 Node 版本（强烈建议）

否则每次开新终端都要 nvm use。

nvm alias default 18

以后：

• 新开终端
• Node 自动就是 18

五、每个项目使用不同 Node（进阶但很实用）

方式一：手动切换

nvm use 16

方式二（推荐）：使用.nvmrc

在项目根目录创建文件：

.nvmrc

内容写：

18

以后进入项目目录：

nvm use

自动切版本。

六、常见错误和避坑指南（必看）

不要同时用 Homebrew 装 Node

如果你之前执行过：

brew install node

建议卸载：

brew uninstall node

否则会出现：

• node -v 和 which node 对不上
• npm 全局包混乱

不要把 nvm 写到多个配置文件

• macOS 默认只用：~/.zshrc
• 不要同时写 .bashrc、.bash_profile

终端里提示nvm: command not found

说明：

• .zshrc 没加载
• 或者没 source ~/.zshrc

七、总结（直接记住这几条）

✅ MacBook 安装 Node 的正确流程是：

1. 官方脚本安装 nvm
2. 用 nvm 安装 Node
3. 设置默认 Node 版本
4. 不用 Homebrew 装 Node

一次配置好，以后几年都不用折腾。

到此这篇关于MacBook上安装nvm和Node.js的文章就介绍到这了,更多相关MacBook安装nvm和Node.js内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论