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 是什么?为什么一定要用?

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 安装 nvm

nvm 本质是 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 ~/.zshrc

4️⃣ 验证 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 18

3️⃣ 使用该版本

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 的正确流程是:

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

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


相关推荐
cpolar技术支持15 小时前
把 agent-autoloop 装在 Mac 上:用本机 Node 实跑一次「接活—提问—拍板—接着干」,再用 cpolar 把它的状态页开给不在工位的自己
node.js·内网穿透·cpolar·ai agent·agent-autoloop
SEO_juper21 小时前
Node.js 全站 SEO 体检报告生成器:一次查完标题、描述、canonical、H1、图片
开发语言·前端·node.js·html·bash
木头左2 天前
【Node.js】Markdown 转带图片 Word 文档实战:docx 库转换器设计与 5 个踩坑
node.js·word·markdown·文档自动化
思特奇时空智能2 天前
大规模点要素地图渲染性能优化实践
vue.js·arcgis·性能优化·node.js·html·gis·webgl
w3296362714 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
濮水大叔5 天前
Cabloy/Vona 为什么不需要 NestJS 的 Dynamic Module
typescript·node.js·nestjs
匠云创新5 天前
读完一万段要两分钟:我们把标书读取从 WPS 对象模型搬到了 docx 解析
性能优化·node.js
某哈压力大5 天前
SSH 突然 Connection reset?不是密钥坏了,是 OpenSSL 把 sshd 干趴了
前端·node.js·命令行
回眸&啤酒鸭5 天前
【回眸】Node.js 新手从零到一实战指南
node.js
浪遏5 天前
recruitment-cli:让 AI 接手求职招聘,从架构到一次发送超时
架构·typescript·node.js