Node.js 版本更新頻繁,不同項目可能依賴不同的版本,手動切換極為麻煩。nvm-windows
是專為 Windows 用戶開發的 Node.js 多版本管理工具,可以輕松地安裝、切換、卸載 Node.js 版本。
本篇將從下載到實際使用,手把手帶你玩轉 nvm-windows
。
一、下載 nvm-windows 安裝包
進入 GitHub 項目地址:nvm-windows Releases
下載最新版的 nvm-setup.zip
安裝包或 .exe
安裝器,建議直接使用 .exe
安裝版本,簡單快捷。
二、安裝 nvm-windows
- 雙擊安裝程序開始安裝。
- 選擇 nvm 安裝路徑。
- 選擇 Node.js 安裝路徑。
📌 注意:**不要使用帶空格的路徑!**如
C:\Program Files
這種路徑可能引起后續問題。
安裝完成后,打開 PowerShell
或命令行窗口,輸入:
nvm version
若成功輸出版本號,如:
1.2.2
說明安裝成功 ?
三、常用 nvm-windows 命令速查
命令 | 說明 |
---|---|
nvm install <version> | 安裝指定版本 Node.js |
nvm install <version> [arch] | 指定架構安裝(32/64位) |
nvm list / nvm ls | 列出已安裝版本 |
nvm list available | 查看可安裝的所有版本 |
nvm use <version> | 切換使用某個版本 |
nvm uninstall <version> | 卸載某個版本 |
nvm root [path] | 設置或查看 nvm 根目錄 |
nvm proxy [url] | 設置代理 |
nvm node_mirror [url] | 設置 Node.js 鏡像源 |
nvm npm_mirror [url] | 設置 npm 鏡像源 |
nvm arch | 顯示當前架構(32/64) |
四、安裝與切換 Node.js 版本示例
安裝某個版本,推薦安裝LTS版本(如 22.17.0)
nvm install 22.17.0
安裝成功后:
nvm use 22.17.0
切換成功后,可驗證當前版本:
node -v
輸出:
v22.17.0
說明已切換成功 ?
安裝最新版本(如最新穩定版)
nvm install latest
五、升級 Node.js 版本建議流程
-
安裝最新版本:
nvm install 22.17.0
-
切換新版本:
nvm use 22.17.0
-
如需全局 npm 包遷移,可使用以下命令備份/恢復:
npm list -g --depth=0 > global-packages.txt
然后在新版本中重新安裝:
cat global-packages.txt | xargs npm install -g
六、可能遇到的問題與解決
問題 | 解決方案 |
---|---|
nvm use 后 node -v 依然是舊版本 | 檢查環境變量是否配置沖突,刪除舊 Node.js 的 PATH 路徑 |
安裝失敗 | 檢查網絡問題或切換鏡像源為淘寶 |
權限問題 | 使用管理員權限運行 PowerShell 再試 |
七、參考資料
- nvm-windows GitHub 項目
- 阿里 npm 鏡像站
- Node.js 官方下載地址
總結
nvm-windows 是 Windows 開發者管理 Node.js 版本的利器,安裝簡單、切換靈活,適合日常開發使用。合理配置鏡像源,還能大大提升下載速度,推薦每位前端工程師都掌握這項技能。
如果你還在手動切換 Node.js 版本,是時候換上 nvm 了!