Skip to content

建立 2026-09-12 更新 2026-09-12

用 nvm 安裝

nvm（Node Version Manager）用來在同一台電腦安裝、切換多個 Node.js 版本。專案常指定不同版本；用 nvm 切換，就不必反覆卸載重裝。

裝好 Node 時通常會一併得到 npm。正確順序是：先裝 nvm → 再用 nvm 裝 Node → 然後才用 npm。

為什麼用 nvm

官網安裝檔會在整台電腦裝「唯一一個」Node。專案 A 要 18、專案 B 要 22 時，就會互相踩。nvm 讓每個終端機可以選自己要用的版本。

學習與專案請裝 LTS（Long-Term Support，長期支援）：官方保證較長時間維護，套件也比較跟得上。Current 是新功能測試版，課內不要追。

Windows 與 macOS / Linux 不是同一個 nvm

系統 建議工具 說明
Windows nvm-windows 獨立專案，指令很像，但不是 Unix 的 nvm
macOS / Linux nvm 常見的 Node 版本管理器

不要混裝

已經用官網 .msi / .pkg 裝過 Node 的人，先卸載官方版本，再裝 nvm。兩套同時存在時，終端機常會找到錯的 Node。

Windows：nvm-windows

  1. 若已安裝官方 Node.js，先解除安裝。
  2. 到 nvm-windows Releases 下載 nvm-setup.exe。
  3. 安裝後重新開啟終端機。
  4. 確認指令存在：
nvm version

安裝並使用 LTS：

nvm list available
nvm install lts
nvm use lts
node -v
npm -v

常用指令：

nvm list              # 已安裝的版本
nvm install 22.20.0   # 安裝指定版本
nvm use 22.20.0       # 切換版本
nvm current           # 目前版本
nvm uninstall 18.20.0 # 移除舊版

nvm use 只影響目前這個終端機視窗。用 where.exe node 檢查路徑：應落在 nvm 目錄，而不是 Program Files\nodejs（那是官網安裝檔的位置）。切換失敗時，試著以系統管理員開啟終端機。

macOS / Linux：nvm

依 nvm 官方說明 安裝，完成後重開終端機。

nvm --version
nvm install --lts
nvm alias default 'lts/*'
nvm use --lts
node -v
npm -v

常用指令：

nvm ls                 # 本機已安裝版本
nvm ls-remote --lts    # 遠端 LTS
nvm install 22         # 安裝 22 的最新版
nvm use 22             # 切換
nvm uninstall 18       # 移除

專案根目錄可放 .nvmrc（內容寫 lts/* 或 22）。之後進入該目錄執行 nvm use（後面不用再寫版本），就會照檔案切換。nvm-windows 對 .nvmrc 支援較不完整，可改在 README 註明版本。

日常只記五件事

  1. nvm install：裝一個 Node（會附 npm）。
  2. nvm use：切換目前終端機的版本。
  3. nvm list / nvm ls：看本機有哪些版本。
  4. 進專案先對齊版本，再跑 npm install。
  5. 用 node -v、npm -v 確認眼前這個終端機真的切對了。