以下是 Windows 11 系統下使用 NVM 安裝 Node.js 并實現版本自由切換的詳細步驟:
一、安裝 NVM(Node Version Manager)
1. 卸載已有 Node.js
如果已安裝 Node.js,請先卸載:
- 控制面板???程序與功能?? 找到?
Node.js
,右鍵選擇?卸載。 - 刪除殘留文件(如?
C:\Program Files\nodejs
?或?C:\Users\<用戶名>\AppData\Roaming\npm
)。
2. 下載 NVM for Windows
- 訪問?nvm-windows GitHub 發布頁。
- 下載最新版本的?
nvm-setup.exe
(如?v1.1.12
)。
3. 安裝 NVM
- 運行安裝程序:
- 雙擊下載的?
nvm-setup.exe
。 - 安裝向導中:
- NVM 安裝路徑:建議選擇無空格的路徑(例如?
D:\Program\nvm
)。 - Node.js 安裝路徑:建議選擇?
D:\Program\nodejs
(后續可修改)。
- NVM 安裝路徑:建議選擇無空格的路徑(例如?
- 雙擊下載的?
- 配置鏡像源(加速下載):
- 安裝完成后,找到 NVM 的安裝目錄(如?
D:\Program\nvm
)。 - 編輯?
settings.txt
?文件,添加以下兩行:node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/
- 安裝完成后,找到 NVM 的安裝目錄(如?
4. 驗證 NVM 安裝
- 以管理員身份運行 PowerShell 或 CMD:
- 按?
Win + S
,搜索?cmd
?或?PowerShell
,右鍵選擇?以管理員身份運行。
- 按?
- 輸入以下命令驗證:
nvm --version
- 若顯示版本號(如?
1.1.12
),表示安裝成功。
- 若顯示版本號(如?
二、安裝和切換 Node.js 版本
1. 查看可安裝的 Node.js 版本
nvm list available
- 會列出所有可安裝的版本(如?
v14.21.3
、v16.20.2
、v18.20.4
?等)。
2. 安裝指定版本
以安裝 v14.21.3
為例:
nvm install 14.21.3
- 安裝過程中會自動下載并配置 Node.js 和 npm。
3. 切換 Node.js 版本
- 查看已安裝版本:
nvm list
- 切換版本:
nvm use 14.21.3
? ? ? 3.驗證版本:? ?????????????????????????????????????????????????????????????????????????????????????????????????
node -v
npm -v
4. 設置默認版本
若希望每次打開終端時自動使用某個版本:
nvm alias default 14.21.3
三、項目級版本管理
1. 在項目目錄中指定版本
- 在項目根目錄創建?
.nvmrc
?文件:echo 14.21.3 > .nvmrc
- 進入項目目錄并自動切換版本:
nvm use
四、常用命令
命令 | 說明 |
---|---|
nvm install <version> | 安裝指定版本 |
nvm use <version> | 切換到指定版本 |
nvm list | 查看已安裝版本 |
nvm list available | 查看可安裝版本 |
nvm uninstall <version> | 卸載指定版本 |
nvm alias default <version> | 設置默認版本 |
npm config set registry https://registry.npmmirror.com | 設置 npm 鏡像源 |
五、注意事項
- 權限問題:
- 必須以?管理員身份運行 PowerShell/CMD,否則可能報錯。
- 環境變量:
- NVM 會自動配置環境變量,無需手動設置。
- 全局模塊隔離:
- 每個 Node.js 版本的全局模塊(
npm install -g
)是獨立的,切換版本后需重新安裝。
- 每個 Node.js 版本的全局模塊(
- 鏡像源加速:
- 如果下載速度慢,確保?
settings.txt
?中的鏡像源已正確配置為國內源(如?npmmirror.com
)。
- 如果下載速度慢,確保?
六、常見問題
1. 安裝失敗?
- 原因:網絡問題或鏡像源未配置。
- 解決:
- 檢查?
settings.txt
?中的鏡像源是否正確。 - 嘗試使用官方鏡像:
https://nodejs.org/dist/
。
- 檢查?
2. NVM 命令未識別?
- 原因:未以管理員身份運行終端。
- 解決:
- 關閉當前終端,重新以?管理員身份運行 PowerShell/CMD。
3. 版本切換后未生效?
- 原因:未正確切換或環境變量沖突。
- 解決:
- 確保使用?
nvm use <version>
?命令切換。 - 避免手動修改系統環境變量?
PATH
。
- 確保使用?
七、實操示例
- 安裝 Node.js v14.21.3 和 v16.20.2:
nvm install 14.21.3 nvm install 16.20.2
- 切換版本:
nvm use 14.21.3 # 切換到 v14.21.3 nvm use 16.20.2 # 切換到 v16.20.2
- 設置默認版本:
nvm alias default 14.21.3
通過以上步驟,你可以在 Windows 11 上輕松管理多個 Node.js 版本,并實現版本自由切換!如果需要進一步幫助,請隨時提問。