適用人群：

• macOS 用戶（Intel / M1 / M2 / M3 都適用）
• 前端 / Node / 全棧 / Java 開發(fā)
• 不想把環(huán)境搞亂的新手

如果你剛開始在 MacBook 上學(xué)習(xí)開發(fā)，Node.js 基本是必裝的。
但很多人一上來就踩坑，比如：

• 用 Homebrew 裝 Node，結(jié)果版本亂
• 想切 Node 版本，卻發(fā)現(xiàn)根本切不了
• 全局包沖突，node -v 和 npm -v 對(duì)不上

?? 正確姿勢(shì)只有一個(gè)：先裝 nvm，再用 nvm 管理 Node。

這篇文章帶你從 0 到 1，一次裝對(duì)，不返工。

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

Node.js 是什么？

• Node.js 是一個(gè) JavaScript 運(yùn)行環(huán)境
• 前端工程（Vue / React / Vite / Next.js）幾乎都離不開它

nvm 是什么？

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

它可以幫你：

• 同時(shí)安裝多個(gè) Node 版本（14 / 16 / 18 / 20）
• 不同項(xiàng)目用不同 Node
• 隨時(shí)切換，不破壞系統(tǒng)環(huán)境

?? 結(jié)論一句話：Mac 上千萬不要只裝一個(gè)裸 Node，一定要用 nvm。

二、macOS 安裝 nvm（官方推薦方式）

?? 注意：
不推薦用 Homebrew 安裝 nvm
nvm 本質(zhì)是 shell 腳本，Homebrew 反而容易把環(huán)境搞復(fù)雜。

正確方式：官方腳本安裝

打開終端（Terminal）

快捷鍵：

Command + 空格 → 輸入 Terminal → 回車

執(zhí)行安裝命令

復(fù)制下面這行，直接粘貼回車：

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

等待執(zhí)行完成。

配置環(huán)境變量（非常重要）

macOS 默認(rèn)使用 zsh，配置文件是 ~/.zshrc

執(zhí)行：

nano ~/.zshrc

確認(rèn)里面有下面內(nèi)容（沒有就加上）：

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

驗(yàn)證 nvm 是否安裝成功

nvm -v

如果能看到版本號(hào)，例如：

0.39.7

? 說明 nvm 安裝成功

三、用 nvm 安裝 Node.js（推薦版本）

查看可安裝的 Node 版本

nvm ls-remote

你會(huì)看到很多版本，不用糾結(jié)。

推薦安裝哪個(gè)版本？

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

nvm install 18

使用該版本

nvm use 18

驗(yàn)證：

node -v
npm -v

看到正常版本號(hào)即可。

四、設(shè)置默認(rèn) Node 版本（強(qiáng)烈建議）

否則每次開新終端都要 nvm use。

nvm alias default 18

以后：

• 新開終端
• Node 自動(dòng)就是 18

五、每個(gè)項(xiàng)目使用不同 Node（進(jìn)階但很實(shí)用）

方式一：手動(dòng)切換

nvm use 16

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

在項(xiàng)目根目錄創(chuàng)建文件：

.nvmrc

內(nèi)容寫：

18

以后進(jìn)入項(xiàng)目目錄：

nvm use

自動(dòng)切版本。

六、常見錯(cuò)誤和避坑指南（必看）

不要同時(shí)用 Homebrew 裝 Node

如果你之前執(zhí)行過：

brew install node

建議卸載：

brew uninstall node

否則會(huì)出現(xiàn)：

• node -v 和 which node 對(duì)不上
• npm 全局包混亂

不要把 nvm 寫到多個(gè)配置文件

• macOS 默認(rèn)只用：~/.zshrc
• 不要同時(shí)寫 .bashrc、.bash_profile

終端里提示nvm: command not found

說明：

• .zshrc 沒加載
• 或者沒 source ~/.zshrc

七、總結(jié)（直接記住這幾條）

? MacBook 安裝 Node 的正確流程是：

1. 官方腳本安裝 nvm
2. 用 nvm 安裝 Node
3. 設(shè)置默認(rèn) Node 版本
4. 不用 Homebrew 裝 Node

一次配置好，以后幾年都不用折騰。

到此這篇關(guān)于MacBook上安裝nvm和Node.js的文章就介紹到這了,更多相關(guān)MacBook安裝nvm和Node.js內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論