適用人群：

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

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

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

?? 正確姿勢只有一個：先裝 nvm，再用 nvm 管理 Node。

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

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

Node.js 是什么？

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

nvm 是什么？

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

它可以幫你：

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

?? 結論一句話：Mac 上千萬不要只裝一個裸 Node，一定要用 nvm。

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

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

正確方式：官方腳本安裝

打開終端（Terminal）

快捷鍵：

Command + 空格 → 輸入 Terminal → 回車

執(zhí)行安裝命令

復制下面這行，直接粘貼回車：

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

等待執(zhí)行完成。

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

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

執(zhí)行：

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

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

.nvmrc

內容寫：

18

以后進入項目目錄：

nvm use

自動切版本。

六、常見錯誤和避坑指南（必看）

不要同時用 Homebrew 裝 Node

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

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內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論