萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Windows 安裝 Node.js 圖文教學(含環境變數驗證、版本管理建議)

Node.js 官方安裝包內含 `node`、`npm`、`npx`、`corepack`,一鍵完成環境部署。本文提供詳細步驟、常見問題、多版本管理工具建議。

步驟 1:下載安裝程式

  • 官網:https://nodejs.org/
  • 選擇 **LTS (Long Term Support)** 版本(偶數版本號,如 v20.x、v22.x),穩定適合生產環境
  • Windows 選 `.msi` (64-bit) 或 `.zip`(免安裝、適合攜帶版)

步驟 2:執行安裝精靈

  1. 雙擊 `.msi` → Next
  2. 勾選 I accept the terms → Next
  3. **安裝路徑**:預設 `C:\Program Files\nodejs\` 可自訂(避免中文、空格路徑)
  4. **自訂安裝**:建議全選(含 `Add to PATH`) → Next
  5. **Tools for Native Modules**:可選勾選(安裝 Python、Visual Studio Build Tools),需編譯原生模組(如 `node-gyp`)時才需要,會額外下載 ~3GB
  6. Install → 完成

步驟 3:驗證安裝

開啟 **新的** 命令提示字元或 PowerShell:

node -v    # 例:v20.15.0
npm -v     # 例:10.7.0
npx -v     # 例:10.7.0
corepack -v # 例:0.28.0

若顯示版本號即安裝成功。舊視窗需重開才會讀取新 PATH。

步驟 4:設定 npm 全域套件目錄(建議)

mkdir %USERPROFILE%\npm-global
npm config set prefix "%USERPROFILE%\npm-global"
# 將 %USERPROFILE%\npm-global 加入「使用者環境變數 PATH」

避免全域安裝需管理員權限、減少 C 槽佔用。

步驟 5:切換 npm 鏡像源(中國大陸/台灣加速)

npm config set registry https://registry.npmmirror.com
# 或臨時使用
npm install --registry=https://registry.npmmirror.com

多版本管理工具(強烈建議)

工具平台特點
nvm-windowsWindows最流行、切換版本快、支援 `nvm use 20`、`nvm list`、`nvm install lts`
fnm跨平台Rust 寫入、極速、支援 `.nvmrc`、Shell 整合佳
Volta跨平台專案級釘選、自動切換、無 Shell hook、適合團隊統一版本
asdf跨平台通用版本管理器、支援 50+ 語言、插件制

**安裝 nvm-windows**:下載 nvm-setup.exe,安裝後重開終端機:

nvm install lts
nvm use 20.15.0
node -v

常見問題

  • `node` 不是內部命令:重開終端機、檢查 PATH 是否含 `C:\Program Files\nodejs`
  • 權限錯誤 (EACCESS):改用 nvm 或設定 npm prefix 到使用者目錄
  • 原生模組編譯失敗:安裝 `windows-build-tools` 或 Visual Studio Build Tools,並設定 `npm config set msvs_version 2022`
  • 企業 Proxy:`npm config set proxy https://proxy:port`、`npm config set https-proxy https://proxy:port`
copyright © 萬盛學電腦網 all rights reserved