開發 Node.js 專案時,經常遇到不同項目需要特定版本的 Node.js,升級後舊專案崩潰,新功能又無法使用,切換麻煩令工作效率大打折扣。nvm(Node Version Manager)正係解決呢個痛點的 POSIX-compliant bash 腳本工具,專為 Linux、macOS 同其他 POSIX 系統設計,讓前端、後端開發者或全棧工程師快速管理多個 Node.js 版本,無需重覆安裝或污染系統環境。呢個開源項目喺 GitHub 上廣受歡迎,透過簡單指令即可安裝、切換同刪除版本,特別適合活躍於多專案的開發團隊。
一鍵安裝與更新腳本,幾分鐘搞定 nvm 環境
nvm 的最大方便之處在於提供單一安裝腳本,直接 curl 執行 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash,即可自動下載並設定環境變數。完成後重新載入 shell 或執行 source ~/.bashrc,就能開始使用。呢個過程比手動編譯 Node.js 版本快得多,避免咗依賴管理同路徑衝突的麻煩。

驗證安裝後,即時列出並安裝 Node.js 版本
安裝完成後,輸入 nvm –version 即可驗證工具運作正常。nvm 內建指令如 nvm list 顯示已安裝版本,nvm install node 安裝最新版,或 nvm install 20.10.0 指定精準版本。呢個設計讓開發者能針對專案需求,例如舊項目用 LTS 18,新項目試最新功能,而唔使擔心全局衝突。相比直接用包管理器如 apt 或 brew,nvm 更精細控制每個版本的 npm 模組目錄。
實際使用中,nvm use 14.21.3 切換版本後,立即生效於當前 shell session,專案依賴如 package.json 指定的引擎版本自動匹配,避免咗 “unsupported engine” 錯誤。呢點對跨團隊協作特別有用,每人本地環境一致性更高。
重要注意事項避免常見陷阱,確保穩定運行
nvm 強調幾個關鍵注意事項,例如安裝後需手動載入 profile 檔案,否則指令可能未識別;另外,Git bash 或 MSYS2 用家需額外設定。工具唔支援 Windows 原生命令提示字元,但 WSL 或 Git bash 透過調整 PATH 即可運作順暢。呢啲提示有助新手避開初期設定障礙,讓管理多版本變得可靠。
對於進階用家,nvm alias default 20 可設定預設版本,nvm uninstall 舊版清理空間。相比其他版本管理器如 fnm 或 volta,nvm 的 bash 原生支援更廣泛,特別喺伺服器部署環境中表現出色。
Git 或手動安裝選項,滿足不同部署需求
如果偏好版本控制,nvm 提供 Git 安裝方式,直接 clone https://github.com/nvm-sh/nvm.git 後執行 nvm/install.sh,同樣簡單。手動安裝則下載最新 release 的 tarball,解壓至 ~/.nvm 並連結 profile。呢兩種方法適合企業環境或 CI/CD pipeline,例如 GitHub Actions 中整合 nvm 腳本,自動切換 Node 版本建置專案。
總括而言,nvm 透過這些靈活安裝途徑,確保咗從個人開發到生產部署的全覆蓋,讓 Node.js 多版本管理變得透明高效。
產品名稱:nvm (Node Version Manager)
官方網站:https://github.com/nvm-sh/nvm

