以下是在 Windows 系統 上使用 NVM(Node Version Manager) 管理多個 Node.js 版本的詳細步驟,從零開始操作:
一、準備工作
-
卸載舊版 Node.js
- 打開 控制面板 → 程序和功能,找到已安裝的 Node.js 和 npm,徹底卸載。
- 刪除殘留環境變量(如
PATH
中的 Node.js 路徑)。 - 清除緩存目錄(如
C:\Users<用戶名>\AppData\Roaming\npm
)。
-
以管理員身份運行命令行工具
- 所有后續操作需以管理員權限運行 CMD 或 PowerShell,避免權限問題。
二、安裝 NVM(Node Version Manager)
-
下載 NVM 安裝包
- 訪問 NVM for Windows 官方 GitHub 發布頁面。
- 下載最新版本的安裝程序(如
nvm-setup.zip
)。
-
運行安裝程序
- 雙擊下載的安裝包(如
nvm-setup.exe
),進入安裝向導。 - 安裝路徑選擇:
- 建議使用默認路徑(如
C:\Users<用戶名>\AppData\Roaming\nvm
),避免路徑含空格。 - 若自定義路徑,請確保路徑無空格(如
D:\nvm
)。
- 建議使用默認路徑(如
- Node.js 安裝路徑:
- 默認路徑為
C:\Program Files\nodejs
,無需手動創建,NVM 會自動處理軟鏈接。
- 默認路徑為
- 雙擊下載的安裝包(如
-
驗證安裝
- 安裝完成后,在管理員 CMD 或 PowerShell 中輸入以下命令:
nvm version
- 如果顯示 NVM 的版本號(如
1.1.12
),說明安裝成功。
- 安裝完成后,在管理員 CMD 或 PowerShell 中輸入以下命令:
三、配置鏡像加速(國內用戶推薦)
- 修改 NVM 配置文件
- 找到 NVM 安裝目錄下的
settings.txt
文件(默認路徑:C:\Users<用戶名>\AppData\Roaming\nvm\settings.txt
)。 - 在文件末尾添加以下內容(使用國內鏡像加速下載):
node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/
- 找到 NVM 安裝目錄下的
四、安裝和管理 Node.js 版本
-
查看可用版本
- 輸入以下命令,查看所有可安裝的 Node.js 版本:
nvm list available
- 輸出示例:
16.15.0 18.20.5 20.14.0
- 輸入以下命令,查看所有可安裝的 Node.js 版本:
-
安裝指定版本
- 選擇需要安裝的版本(如
18.20.5
),輸入以下命令:nvm install 18.20.5
- 等待下載和安裝完成(受鏡像加速影響,速度較快)。
- 選擇需要安裝的版本(如
-
切換 Node.js 版本
- 安裝完成后,輸入以下命令切換版本:
nvm use 18.20.5
- 驗證當前版本:
node -v # 應輸出 v18.20.5 npm -v # 顯示對應的 npm 版本
- 安裝完成后,輸入以下命令切換版本:
-
安裝多個版本
- 重復上述步驟,安裝其他版本(如
16.15.0
和20.14.0
):nvm install 16.15.0 nvm install 20.14.0
- 重復上述步驟,安裝其他版本(如
-
查看已安裝版本
- 輸入以下命令,列出所有已安裝的 Node.js 版本:
nvm list
- 輸入以下命令,列出所有已安裝的 Node.js 版本:
-
卸載指定版本
- 輸入以下命令卸載某個版本(如
16.15.0
):nvm uninstall 16.15.0
- 輸入以下命令卸載某個版本(如
五、項目級版本管理
- 創建
.nvmrc
文件- 在項目根目錄創建
.nvmrc
文件,指定項目所需的 Node.js 版本:echo "20.14.0" > .nvmrc
- 運行以下命令自動切換版本:
nvm use
- 在項目根目錄創建
六、常見問題及解決方案
-
權限不足
- 以管理員身份運行 CMD 或 PowerShell。
-
路徑含空格導致報錯
- 確保 NVM 安裝路徑和 Node.js 安裝路徑無空格(如
D:\nvm
)。
- 確保 NVM 安裝路徑和 Node.js 安裝路徑無空格(如
-
鏡像失效
- 更新
settings.txt
中的鏡像地址,嘗試以下鏡像:node_mirror: https://mirrors.aliyun.com/nodejs-release/ npm_mirror: https://mirrors.aliyun.com/npm/
- 更新
-
切換版本失敗
- 檢查路徑是否正確,重啟終端后重試。
-
NVM 命令無效
- 檢查環境變量
NVM_HOME
和NVM_SYMLINK
是否正確配置,并確保路徑已加入PATH
。
- 檢查環境變量
七、替代方案(不推薦)
如果不使用 NVM,可手動管理 Node.js:
- 從 Node.js 官網 下載 ZIP 包。
- 解壓至獨立目錄(如
D:\nodejs\v18.20.5
)。 - 手動修改
PATH
環境變量切換版本(操作繁瑣,易出錯)。
八、總結
通過 NVM,你可以輕松在 Windows 上管理多個 Node.js 版本,避免版本沖突問題。核心命令包括:
nvm install <version>
:安裝指定版本。nvm use <version>
:切換版本。nvm list
:查看已安裝版本。nvm uninstall <version>
:卸載版本。
如果需要進一步優化開發環境,可結合 Docker 或 Volta 工具實現更靈活的版本管理。