nvm（Node Version Manager）是一個用于管理Node.js版本的命令行工具。通過nvm，你可以在同一臺機器上安裝和切換多個Node.js版本，非常適合開發和測試在不同Node.js版本上運行的應用程序

---

一、安裝地址

1. 官方下載： （推薦選擇nvm-setup.exe安裝包，避免綠色版路徑問題）

下載地址：GitHub nvm-windows最新版

2. 站內下載

下載地址: nvm-setup-1.2.2

---

二、安裝步驟

1. 必須！！！卸載舊版Node.js

• 控制面板 → 卸載Node.js (打開控制面板方法)
• 手動刪除殘留：C:\Program Files\nodejs、用戶目錄下的.npmrc及AppData\Roaming\npm等文件夾
  • C:\Program Files (x86)\Nodejs
  • C:\Program Files\Nodejs
  • C:\Users\用戶名\AppData\Roaming\npm
  • C:\Users\用戶名\AppData\Roaming\npm-cache

2. 安裝NVM

• 安裝路徑：純英文、無空格（例如D:\nvm）
• Node.js路徑：建議與NVM同級目錄（例如D:\nvm\nodejs）

3. 驗證安裝

nvm -v # 顯示版本號即成功

三、配置鏡像源（加速下載）

1. 設置淘寶鏡像源

npm config set registry https://registry.npmmirror.com

原域名https://registry.npm.taobao.org/ 在 2022.06.30 號正式下線和停止 DNS 解析

2. 查看鏡像使用狀態

npm config get registry

設置成功如下

---

四、核心使用命令

命令	功能描述	備注
nvm list available	查看可安裝版本
nvm install 18.16.0	安裝指定版本
nvm use 18.16.0	切換版本
nvm ls	查看已安裝版本（帶*為當前）
nvm uninstall 14.17.0	卸載版本
nvm install --lts	安裝最新LTS（穩定版）
npm config set registry …	設置npm鏡像（中國用戶必選）	https://registry.npmmirror.com

---

五、常見問題

1. 切換版本后命令失效

• 管理員權限運行CMD
• 檢查路徑是否含中文/空格

2. 鏡像源報錯

• 確認鏡像地址是否為https://registry.npmmirror.com新域名

3. NVM無法識別Node

• 徹底卸載舊版Node環境變量

---

六、環境變量配置（自動完成）

NVM安裝后默認自動配置系統變量，無需手動操作。若需自定義全局模塊路徑：

npm config set prefix "D:\nvm\node_global"
npm config set cache "D:\nvm\node_cache"

（路徑需與NVM目錄一致）

---

效率提示：使用nvm use前，建議通過nvm list確認版本狀態，避免路徑沖突。

附錄：NVM 常用命令表詳細版

命令	描述	示例
nvm install <版本號>	安裝指定版本的Node.js	nvm install 16.14.0
nvm install --lts	安裝最新的LTS（長期支持）版本	nvm install --lts
nvm use <版本號>	切換到指定版本的Node.js	nvm use 16.14.0
nvm ls	列出所有已安裝的Node.js版本	nvm ls
nvm ls-remote	列出所有可安裝的Node.js版本	nvm ls-remote
nvm ls-remote --lts	列出所有可安裝的LTS版本	nvm ls-remote --lts
nvm uninstall <版本號>	卸載指定版本的Node.js	nvm uninstall 14.17.0
nvm current	顯示當前使用的Node.js版本	nvm current
nvm alias <別名> <版本號>	為指定版本設置別名	nvm alias default 16.14.0
nvm unalias <別名>	刪除指定的別名	nvm unalias default
nvm reinstall-packages <版本>	將全局npm包從一個版本重新安裝到另一個版本	nvm reinstall-packages 14.17.0
nvm on	啟用nvm	nvm on
nvm off	禁用nvm	nvm off
nvm version	顯示nvm的版本號	nvm version
nvm cache dir	顯示nvm的緩存目錄	nvm cache dir
nvm cache clear	清除nvm的緩存	nvm cache clear
nvm exec <版本號> <命令>	在指定版本的Node.js中運行命令	nvm exec 16.14.0 node -v
nvm run <版本號> <腳本>	使用指定版本的Node.js運行腳本	nvm run 16.14.0 app.js
nvm which <版本號>	顯示指定版本的Node.js可執行文件路徑	nvm which 16.14.0