SEARCH

nvm下載安裝教程Windows/macOS/Linux多版本Node.js高效管理終極指南

2025-08-19 05:17:26

作為一名現代前端或後端開發者，您很可能需要同時處理多個Node.js項目。而這些項目，往往依賴於不同版本的Node.js。想象一下，一個項目需要Node.js 14，而另一個新項目則要求Node.js 18，如果沒有一個高效的工具來管理這些版本，您可能會陷入頻繁卸載和安裝的麻煩之中。幸運的是，NVM（Node Version Manager）正是為解決這一痛點而生。

什麼是NVM？為什麼你需要它？

NVM，全稱Node Version Manager，顧名思義，它是一個Node.js版本管理器。它允許您在同一台計算機上輕鬆地安裝、管理和切換不同版本的Node.js。這意味著您不再需要為了適應不同項目的Node.js版本要求而卸載舊版本、安裝新版本，NVM能夠讓這一切變得輕而易舉。

為什麼你需要NVM？

  • 多項目開發：不同的項目可能基於不同的Node.js版本構建。
  • 兼容性測試：在發布您的應用程序之前，您可能需要在多個Node.js版本下進行測試。
  • 保持更新：您可以輕鬆地嘗試最新版本的Node.js，同時保留舊版本以應對舊項目的需求。
  • 簡化環境配置：告別手動下載、配置環境變數的繁瑣步驟。

本教程將手把手指導您完成NVM的下載、安裝以及基本使用，無論您是Windows、macOS還是Linux用戶，都能找到適合您的詳細步驟。

NVM下載：從何處獲取與準備工作

在開始安裝NVM之前，請務必進行一些準備工作，以確保安裝過程的順利進行。

1. NVM for Windows下載

對於Windows用戶，NVM有一個專門的版本，由Corey Butler維護。請通過以下步驟進行下載：

  1. 訪問官方GitHub倉庫：打開您的瀏覽器，訪問NVM for Windows的GitHub Release頁面。
  2. 選擇最新版本：在"Assets"部分，找到最新版本的nvm-setup.zip或nvm-setup.exe文件。通常，下載.zip文件后解壓，裡面會包含nvm-setup.exe安裝程序。推薦直接下載.exe安裝程序。
  3. 下載文件：點擊鏈接下載該文件到您的本地計算機。


重要提示：
在下載和安裝NVM for Windows之前，強烈建議您卸載系統中已有的Node.js和npm。這是因為NVM會接管Node.js的安裝和路徑管理，如果之前有手動安裝的Node.js，可能會導致衝突。請通過「控制面板」->「程序和功能」進行卸載。同時，檢查並刪除環境變數中與Node.js相關的路徑（如NODE_HOME或指向Node.js安裝目錄的Path條目）。

2. NVM for macOS/Linux下載（通過Shell腳本）

對於macOS和Linux用戶，NVM通常通過一個簡單的shell腳本進行安裝。

  1. 打開終端：打開您的終端應用程序（Terminal、iTerm2等）。
  2. 執行下載安裝腳本：

    推薦使用curl命令來下載並執行安裝腳本。請注意，以下命令中的版本號（如v0.39.7）可能會隨著NVM的更新而改變，建議您訪問NVM的GitHub官方頁面查看最新的安裝命令。

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    如果您的系統沒有安裝curl，或者您偏好使用wget，可以使用：

    wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    該腳本會將NVM克隆到~/.nvm目錄，並嘗試將其添加到您的shell配置文件中（例如~/.bashrc, ~/.zshrc, 或 ~/.profile）。


重要提示：
與Windows類似，在macOS/Linux上安裝NVM之前，強烈建議您卸載或移除所有通過Homebrew、apt、yum或其他方式安裝的Node.js和npm。這可以避免潛在的路徑衝突和版本管理混亂。

NVM安裝：分步指南與環境配置

1. NVM for Windows安裝步驟

如果您下載的是nvm-setup.exe文件，直接雙擊運行即可。

  1. 運行安裝程序：雙擊您下載的nvm-setup.exe文件。
  2. 同意許可協議：閱讀許可協議，選擇「I accept the agreement」，然後點擊「Next」。
  3. 選擇NVM安裝路徑：

    選擇NVM本身的安裝路徑。強烈建議選擇一個不包含空格的路徑，例如：C: vm。這有助於避免後續可能出現的路徑識別問題。點擊「Next」。

  4. 選擇Node.js安裝路徑：

    選擇NVM管理下的Node.js版本的安裝路徑。這個路徑會被NVM用作symlink（符號鏈接）來指向當前激活的Node.js版本。同樣，建議選擇一個不包含空格的路徑，例如：C: odejs。點擊「Next」。

  5. 完成安裝：點擊「Install」開始安裝。安裝完成後，點擊「Finish」退出安裝嚮導。
  6. 驗證安裝：

    打開一個新的命令提示符（CMD）或PowerShell窗口（切記：必須是新開的窗口，以確保環境變數已刷新）。輸入以下命令：

    nvm --version

    如果您看到NVM的版本號，說明NVM已成功安裝並配置到您的系統路徑中。如果提示「nvm不是內部或外部命令」，則需要檢查環境變數。

  7. 檢查環境變數（如果驗證失敗）：

    右鍵點擊「此電腦」->「屬性」->「高級系統設置」->「環境變數」。

    • 在「用戶變數」或「系統變數」中，檢查是否存在NVM_HOME和NVM_SYMLINK這兩個變數，它們應該指向您在安裝過程中選擇的NVM安裝路徑和Node.js符號鏈接路徑。
    • 在「Path」變數中，檢查是否包含%NVM_HOME%和%NVM_SYMLINK%。確保它們的順序正確，且沒有其他指向舊Node.js的路徑。

    確認無誤后，重啟命令提示符或PowerShell，再次嘗試nvm --version。

2. NVM for macOS/Linux安裝步驟

在macOS和Linux上，NVM的安裝主要涉及執行腳本和配置環境變數。

  1. 執行下載命令：

    如果您已經按照前面「下載」部分的步驟執行了curl或wget命令，那麼NVM的核心文件應該已經下載到了~/.nvm目錄。

  2. 配置環境變數：

    安裝腳本通常會自動嘗試修改您的shell配置文件，例如~/.bashrc（Bash用戶）、~/.zshrc（Zsh用戶）或~/.profile。它會在文件末尾添加類似以下幾行：

    export NVM_DIR="$HOME/.nvm"
    [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm
    [ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion" # This loads nvm bash_completion

    手動檢查與添加：如果NVM命令仍然不識別，請手動打開您的shell配置文件（例如，使用nano ~/.zshrc或vim ~/.bashrc），檢查這些行是否存在。如果不存在，請手動添加它們。

  3. 刷新shell配置：

    在修改了shell配置文件后，您需要使其生效。您可以選擇關閉並重新打開終端窗口，或者在當前終端中執行以下命令：

    source ~/.bashrc (如果您使用的是Bash)

    source ~/.zshrc (如果您使用的是Zsh)

    source ~/.profile (如果NVM配置在.profile中)

  4. 驗證安裝：

    在終端中輸入以下命令：

    nvm --version

    如果顯示NVM的版本號，則表示安裝成功。

NVM基本使用：輕鬆管理Node.js版本

NVM安裝成功后，就可以開始利用它強大的版本管理功能了。以下是一些最常用的NVM命令：

1. 查看NVM版本信息

確認NVM是否安裝成功，並查看當前NVM的版本號。

nvm --version

2. 列出所有可安裝的Node.js版本

這個命令會列出所有可以從Node.js官方倉庫下載的Node.js版本，包括LTS（長期支持版）和Current（最新版）。

nvm ls-remote

列表可能很長，您可以使用grep或findstr篩選：

nvm ls-remote | grep "lts" (查找LTS版本)

3. 安裝指定版本的Node.js

根據您的項目需求，安裝特定的Node.js版本。

nvm install 16.14.0 (安裝指定版本，例如Node.js 16.14.0)

nvm install lts/gallium (安裝最新LTS版本，例如Gallium是Node.js 16的代號)

nvm install node (安裝最新穩定版Node.js)

安裝成功后，NVM會自動將這個版本設置為當前使用版本。

4. 切換Node.js版本

這是NVM最核心的功能之一，讓您在不同項目間無縫切換Node.js版本。

nvm use 16.14.0 (切換到已安裝的Node.js 16.14.0版本)

nvm use lts/gallium (切換到已安裝的LTS Gallium版本)

重要提示：當您使用nvm use命令切換Node.js版本時，對應的npm（Node Package Manager）版本也會隨之切換，因為它與Node.js版本是綁定的。

5. 設置默認Node.js版本

您可以設置一個默認的Node.js版本，這樣每當您打開新的終端窗口時，NVM都會自動使用該版本。

nvm alias default 16.14.0 (設置Node.js 16.14.0為默認版本)

nvm alias default lts/gallium (設置LTS Gallium為默認版本)

6. 卸載Node.js版本

當某個Node.js版本不再需要時，您可以將其卸載。

nvm uninstall 16.14.0 (卸載Node.js 16.14.0版本)

注意：您不能卸載當前正在使用的Node.js版本。需要先切換到其他版本，然後才能卸載。

7. 查看當前和已安裝的Node.js版本

查看所有通過NVM安裝的Node.js版本，並標記出當前正在使用的版本。

nvm ls

查看當前正在使用的Node.js版本。

nvm current

NVM常見問題及故障排除

在使用NVM的過程中，您可能會遇到一些常見問題。本節將提供一些解決方案。

問題1：安裝后nvm命令無法識別？

原因：環境變數沒有正確配置或沒有生效。
解決方案：

  • Windows：
    • 確保您打開的是一個新的命令提示符或PowerShell窗口。
    • 檢查系統或用戶環境變數中NVM_HOME、NVM_SYMLINK以及Path中是否包含它們。
    • 特別注意：NVM的安裝路徑和Node.js的符號鏈接路徑不能包含空格。如果路徑中包含空格，請重新安裝NVM到無空格的路徑。
  • macOS/Linux：
    • 確保您的shell配置文件（如~/.bashrc, ~/.zshrc）中包含了NVM的載入腳本。
    • 執行source ~/.bashrc（或對應文件）命令刷新配置。
    • 如果NVM目錄許可權不足，嘗試使用chmod命令更改許可權，例如：chmod -R 755 ~/.nvm。

問題2：NVM安裝的Node.js無法使用npm？

原因：通常情況下，NVM在安裝Node.js時會一同安裝對應版本的npm。如果npm無法使用，可能是以下原因：
解決方案：

  • 確保您已經成功地使用nvm use <version>命令切換到了某個Node.js版本。
  • 嘗試重新安裝當前版本的Node.js，命令為：nvm install <current_version> --reinstall-packages-from=<current_version>（如果需要遷移全局包）。
  • 檢查NPM的鏡像源是否被設置為國內鏡像導致網路問題，嘗試切換回官方源：

    npm config set registry https://registry.npmjs.org/

問題3：如何解決網路代理問題導致下載失敗？

原因：在某些網路環境下，直接從GitHub或Node.js官方下載可能會遇到網路問題或被代理阻擋。
解決方案：

  • 設置NVM代理：NVM自身並沒有直接設置代理的命令。您需要配置系統的HTTP/HTTPS代理環境變數。
    • Windows (CMD):

      set HTTP_PROXY=http://your.proxy.com:port
      set HTTPS_PROXY=http://your.proxy.com:port

    • macOS/Linux (Terminal):

      export HTTP_PROXY="http://your.proxy.com:port"
      export HTTPS_PROXY="http://your.proxy.com:port"

  • 使用淘寶鏡像（僅限npm安裝包）：NVM下載Node.js本身是直接從官方源。但如果您安裝npm包時遇到問題，可以設置npm使用淘寶鏡像：

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

    如果需要恢復官方源：

    npm config set registry https://registry.npmjs.org/

問題4：macOS/Linux下安裝失敗或許可權問題？

原因：執行安裝腳本時可能遇到許可權不足，或者curl/wget未能正確執行。
解決方案：

  • 不要使用sudo安裝NVM：NVM被設計為無需root許可權即可運行，使用sudo反而可能導致許可權問題。確保您以普通用戶身份執行安裝腳本。
  • 檢查curl/wget的輸出，看是否有錯誤信息。如果提示未找到命令，請先安裝它們。
  • 手動檢查~/.nvm目錄及其子目錄的許可權，確保您的用戶擁有讀寫執行許可權。

問題5：Windows NVM安裝后無法切換版本或Node.js模塊丟失？

原因：這通常與Windows的符號鏈接許可權、文件系統路徑或殺毒軟體的干擾有關。
解決方案：

  • 管理員許可權：嘗試以管理員身份運行命令提示符或PowerShell，再執行nvm use命令。
  • 殺毒軟體：某些殺毒軟體可能會誤報NVM創建的符號鏈接或Node.js安裝文件，導致文件被隔離或刪除。嘗試暫時禁用殺毒軟體后重新安裝或切換。
  • 路徑檢查：再次確認NVM安裝路徑和Node.js符號鏈接路徑都沒有空格。

總結：擁抱NVM，告別Node.js版本混亂

通過本文的詳細NVM下載安裝教程，您應該已經成功地在您的操作系統上安裝並配置了NVM。NVM無疑是每一位Node.js開發者手中的利器，它徹底解決了Node.js多版本管理的痛點，讓您能夠輕鬆在不同項目間切換，高效地進行開發和測試。

現在，您已經掌握了NVM的安裝和基本使用方法，可以更加從容地面對各種Node.js項目的版本要求。祝您在Node.js開發的道路上一帆風順，創作出更多優秀的應用！

常見問題解答 (FAQ)

Q1：如何查看我當前NVM管理的Node.js版本列表？

您可以使用命令nvm ls來查看所有已通過NVM安裝的Node.js版本。該命令還會用箭頭指示當前正在使用的Node.js版本。

Q2：為何我安裝了NVM，但npm命令依然無法識別或版本不對？

首先，請確保您已經成功使用nvm use <version>命令切換到了一個特定的Node.js版本。NPM是Node.js的一部分，NVM在切換Node.js版本時會自動切換相應的npm版本。如果仍有問題，請嘗試重新打開終端或命令提示符，或者檢查環境變數設置是否正確，確保NVM的路徑優先於其他Node.js安裝路徑。

Q3：如何設置NVM以自動使用最新穩定版Node.js？

您可以先使用nvm install node安裝最新的穩定版Node.js，然後使用nvm alias default node將其設置為默認版本。這樣，每次您打開新的終端窗口時，NVM都會自動載入最新的Node.js穩定版。

Q4：在Windows上，NVM和Node.js的安裝路徑應該如何選擇？

在Windows上安裝NVM時，強烈建議您將NVM本身的安裝路徑（NVM_HOME）和NVM管理下Node.js的符號鏈接路徑（NVM_SYMLINK）都設置在不包含任何空格的目錄下，例如C: vm和C: odejs。這可以有效避免因路徑空格導致的環境變數識別錯誤。

Q5：如何完全卸載NVM及其所有Node.js版本？

Windows：進入「控制面板」->「程序和功能」，找到「nvm」並卸載。然後手動刪除NVM和Node.js的安裝目錄，並清除環境變數中所有NVM和Node.js相關的條目。
macOS/Linux：首先刪除NVM的安裝目錄（通常是~/.nvm），命令為rm -rf ~/.nvm。然後編輯您的shell配置文件（如~/.bashrc, ~/.zshrc），刪除其中所有NVM相關的行。最後，重新啟動終端或執行source命令刷新配置。

nvm下載安裝教程
如發現政治性、事實性、技術性差錯和版權方面的問題及不良信息，請及時與我們聯繫。 365lvtu.com © 2019-2022. All Rights Reserved.