在 Windows 上安裝 NodeJS

  • 發行項

如果您不熟悉使用 Node.js 進行開發，而且想要快速啟動並執行，以便您了解，請遵循下列步驟，直接在 Windows 上安裝 Node.js。

注意

如果您是使用 Node.js 的專業人員，發現效能速度和系統呼叫相容性很重要，想要執行利用 Linux 工作區的 Docker 容器，並避免必須同時維護 Linux 和 Windows 組建指令碼，或只偏好使用 Bash 命令列，那麼請在 Windows 子系統 Linux 版上安裝 Node.js (更具體來說，WSL 2)。

安裝 nvm-windows、node.js 和 npm

除了選擇要在 Windows 或 WSL 上安裝之外，安裝 Node.js 時還有其他選擇。 由於版本變更非常快速，因此，我們建議使用版本管理員。 您可能需要根據您正在處理的不同專案需求，在多個 Node.js 版本之間切換。 Node 版本管理員 (較常稱為 nvm) 是安裝多個 Node.js 版本的最熱門方式，但僅適用 Mac/Linux，且在 Windows 上不受支援。 相反地，建議您安裝 nvm-windows，然後使用它來安裝 Node.js 和 Node Package Manager (npm)。 下一節也會涵蓋需考量的替代版本管理員。

重要

安裝版本管理員之前，一律建議您從作業系統中移除任何現有的 Node.js 或 npm 安裝，因為不同類型的安裝可能導致奇怪且困惑的衝突。 這包括刪除任何可能保留的現有 nodejs 安裝目錄 (例如 "C:\Program Files\nodejs")。 NVM 產生的符號連結將不會覆寫現有的 (甚至是空的) 安裝目錄。 如需移除先前安裝的說明，請參閱如何從 Windows 完全移除 Node.js \(英文\)。

警告

NVM 的設計目的是要依每個使用者安裝，並叫用每個殼層。 它並非針對共用開發人員箱或具有多個組建代理程式的組建伺服器所設計。 NVM 的運作方式是使用符號連結。 在共用案例中使用 nvm 會造成問題，因為該連結會指向使用者的應用程式資料夾，因此如果使用者 x 執行 nvm use lts，連結會將整個箱的節點指向其應用程式資料夾。 如果使用者 y 執行 node 或 npm，則會將他們導向執行 x 使用者帳戶下的檔案，如果是 npm -g，則會修改 x 的檔案，其預設不被允許。 因此 nvm 僅適用一個開發人員箱 這也適用組建伺服器。 如果兩個組建代理程式位於相同的虛擬機器/箱上，它們可能會競爭並導致組建中的怪異行為。

  1. 遵循 windows-nvm 存放庫上的安裝指示。 建議您使用安裝程式，但如果您對需求有更進階的了解，建議您考慮手動安裝。 安裝程式會將您指向最新版本的版本頁面。

  2. 下載最新版的 nvm-setup.zip 檔案。

  3. 下載之後，開啟 zip 檔案，然後開啟 nvm-setup.exe 檔案。

  4. [設定 NVM for Windows] 安裝精靈將引導您完成設定步驟，包括選擇將安裝 nvm-windows 和 Node.js 的目錄。

    NVM for Windows installation wizard

  5. 安裝完成之後。 開啟 PowerShell (建議以提升的系統管理員權限開啟)，並嘗試使用 windows-nvm 來列出目前安裝的 Node 版本 (此時應該沒有任何版本)：nvm ls

    NVM list showing no Node versions

  6. 安裝目前的 Node.js 版本 (用以測試最新的功能改進，但相較於 LTS 版本，更可能發生問題)：nvm install latest

  7. 首先，使用 nvm list available 來查閱目前的 LTS 版本號碼，然後使用 nvm install <version> 來安裝 LTS 版本號碼 (以版本號碼取代 <version>，例如 nvm install 12.14.0)，以安裝 Node.js 的最新穩定 LTS 版本 (建議)。

    NVM list of available versions

  8. 列出已安裝的 Node 版本：nvm ls ... 現在您應該會看到您剛安裝的兩個版本。

    NVM list showing installed Node versions

  9. 安裝所需的 Node.js 版本號碼之後，請輸入：nvm use <version> (將 <version> 取代為數字，也就是：nvm use 12.9.0)，以選取您想要使用的版本。

  10. 若要變更您想要用於專案的 Node.js 版本，請建立新的專案目錄 mkdir NodeTest，並進入目錄 cd NodeTest，然後輸入 nvm use <version>，使用您想要使用的版本號碼來取代 <version> (例如 v10.16.3)。

  11. 使用 npm --version 來確認已安裝的 npm 版本，此版本號碼將自動變更為與您目前 Node.js 版本相關聯的任何 npm 版本。

替代版本管理員

雖然 windows-nvm 是目前最熱門的 Node 版本管理員，但有一些替代方案可以考慮：

  • nvs \(英文\) (Node 版本切換器) 是跨平台的 nvm 替代方案，能夠與 VS Code 整合 \(英文\)。

  • Volta \(英文\) 是由 LinkedIn 小組所提供的新版本管理員，其聲稱已改良速度並提供跨平台支援。

若要將 Volta 安裝為版本管理員 (而非 windows-nvm)，請移至其入門指南 的 Windows 安裝一節，然後下載並執行其 Windows 安裝程式，並遵循安裝指示。

重要

安裝 Volta 之前，您必須確定已在 Windows 電腦上啟用開發人員模式。

若要深入了解如何使用 Volta 在 Windows 上安裝多個 Node.js 版本，請參閱 Volta 文件 \(英文\)。

安裝 Visual Studio Code

建議安裝 Visual Studio Code 以便在 Windows 上使用 Node.js 進行開發。 如需說明，請參閱 Visual Studio Code 中的 Node.js 教學課程。

替代程式碼編輯器

如果您想要使用 Visual Studio Code 以外的程式碼編輯器或 IDE，以下也是 Node.js 開發環境的絕佳選項：

安裝 Git

如果您計畫與其他人合作，或在開放原始碼網站 (如 GitHub) 上裝載您的專案，VS Code 支援使用 Git 進行版本控制 \(英文\)。 VS Code 中的 [原始檔控制] 索引標籤會追蹤您所有的變更，並讓常用的 Git 命令 (add、commit、push、pull) 直接內建在 UI 中。 您首先必須安裝 Git，才能強化 [原始檔控制] 面板。

  1. 從 git-scm 網站下載並安裝適用於 Windows 的 Git。

  2. 隨附的安裝精靈會詢問您有關 Git 安裝設定的一系列問題。 建議您使用所有預設設定，除非您有特定原因，非變更某些設定不可。

  3. 如果您之前從未使用過 Git，GitHub 指南可以協助您開始使用。

  4. 我們建議您將 .gitignore 檔案 \(英文\) 新增至您的 Node 專案。 以下是適用於 Node.js 的 GitHub 預設 gitignore 範本。

針對實際執行環境使用 Windows 子系統 Linux 版

直接在 Windows 上使用 Node.js，非常適合用來了解及實驗您可以執行的作業。 當您準備好建置可供實際執行環境使用的 Web 應用程式 (通常會部署到 Linux 型伺服器) 時，建議您使用 Windows 子系統 Linux 版第 2 版 (WSL 2) 來開發 Node.js Web 應用程式。 許多 Node.js 套件和架構都是以 *nix 環境作為考量，而且大部分的 Node.js 應用程式都部署於 Linux 上，因此，在 WSL 上進行開發，可確保在您的開發與實際執行環境之間具有一致性。 若要設定 WSL 開發環境，請參閱使用 WSL 2 設定您的 Node.js 開發環境。

注意

如果您處於需要在 Windows 伺服器上裝載 Node.js 應用程式的 (有點罕見) 情況下，最常見的案例似乎是使用反向 Proxy \(英文\)。 有兩種方式可以執行此動作：1) 使用 iisnode 或直接執行。 我們不會維護這些資源，建議使用 Linux 伺服器來裝載您的 Node.js 應用程式。