前言

Node.js 幾乎是現(xiàn)代前端和后端開發(fā)繞不開的運行時環(huán)境。但很多新手在安裝配置時容易踩坑——比如裝完了命令行里卻找不到 node、全局模塊裝完不知道去哪了、npm 下載慢得像蝸牛，等等。

本文將帶你從零開始，完成 Node.js 在 Windows 上的安裝、環(huán)境配置、鏡像加速，以及常見問題的排查與解決。

一、什么是 Node.js

簡單說，Node.js 是一個基于 Chrome V8 引擎的 JavaScript 運行時，讓你能在瀏覽器之外跑 JS 代碼。

裝好 Node.js 之后你會同時獲得兩個命令行工具：

• node — 運行 JavaScript 的運行時
• npm — Node 包管理器，用來安裝第三方庫

二、下載安裝包

版本選擇

去 Node.js 官網(wǎng) 會看到兩個版本：

截至 2026 年 6 月，推薦下載 v22.x LTS。

國內鏡像加速下載

官網(wǎng)下載在國內有時候很慢，可以用國內鏡像：

• 阿里云鏡像： CNPM Binaries Mirror
• 騰訊云鏡像： Index of /nodejs-release/
• 華為云鏡像： Index of nodejs-local

選對應的大版本號（如 v22.20.0/），下載 node-v22.20.0-x64.msi 或 node-v22.20.0-x64.zip。

推薦下 .msi 安裝包，圖形化界面一路點就行。

三、安裝步驟

3.1 運行安裝程序

雙擊下載好的 .msi 文件，進入安裝向導。

3.2 接受許可協(xié)議

勾選 "I accept the terms in the License Agreement"，點 Next。

3.3 選擇安裝路徑

重點：不要用默認的 C 盤路徑。

默認路徑是 C:\Program Files\nodejs\，建議改到其他盤，比如：

?D:\NodeJs\Node

這樣做的好處：重裝系統(tǒng)不怕丟、路徑好記、方便排查問題。

3.4 選擇安裝組件

這里一般保持默認就行，所有組件都選中。特別注意：

• npm package manager — 必裝
• Add to PATH — 必選，否則裝完系統(tǒng)找不到 node 命令

3.5 自動安裝工具（可選）

安裝到最后一步會彈出一個復選框，問你要不要自動安裝 Chocolatey 等額外工具。

勾掉，不需要。 直接點 Finish 完成安裝。

四、驗證安裝

打開一個新的 PowerShell 或 CMD 窗口，依次輸入：

?node --version

預期輸出類似：

?v22.20.0

再驗證 npm：

?npm --version

預期輸出類似：

?10.9.0

如果兩個命令都能正常輸出版本號，說明安裝成功了。

五、配置 npm

5.1 修改全局模塊安裝路徑

npm 默認把全局模塊裝在 C 盤，C 盤空間寶貴，建議改到其他盤。

在 Node.js 安裝目錄（比如 D:\NodeJs\Node）下新建兩個文件夾：

?D:\NodeJs\Node\node_global ? ? ? ?  ← 全局模塊
?D:\NodeJs\Node\node_cache ? ? ? ? ? ← 緩存

創(chuàng)建完畢后，復制剛剛創(chuàng)建的【node_global】和【node_cache】文件夾路徑在cmd命令分別輸入以下兩條命令，注意不要兩條命令的文件路徑不要搞混了。

注：可以打開所創(chuàng)建的文件夾，把鼠標放在箭頭指向的位置選擇復制。

使用管理員身份打開cmd命令窗口，輸入以下命令（下面的路徑是我創(chuàng)建的文件夾所在的路徑，需要復制你們自己創(chuàng)建的路徑哦）

然后在命令行里設置：

?#npm config set prefix “你的路徑\node_global” 
 #（復制剛剛所創(chuàng)建的“node_global”文件夾路徑）
 npm config set prefix "D:\NodeJs\Node\node_global"

 #npm config set cache “你的路徑\node_cache”  
 #（復制剛剛所創(chuàng)建的“node_cache”文件夾路徑）
?npm config set cache "D:\NodeJs\Node\node_cache"

5.2 把新的 global 路徑加入 PATH

不然后續(xù)用 npm install -g xxx 裝的全局命令會找不到。

打開"環(huán)境變量" → 在系統(tǒng)變量 Path 中：

1. 把原來的 D:\NodeJs\Node\node_global 之前的 npm 默認路徑刪掉（如果有的話），添加一條新記錄：D:\NodeJs\Node\node_global(將默認的 C 盤下【 AppData\Roaming\npm 】修改成 【node_global】的路徑)
2. 在【系統(tǒng)變量】中選擇【Path】點擊【編輯】后點擊新建【%NODE_PATH%】

順便把 D:\NodeJs\Node 也確認在 PATH 里。

5.3 配置淘寶鏡像（國內必備）

npm 默認去 registry.npmjs.org 拉包，國內下載容易超時或極慢。換成國內鏡像：

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

驗證是否生效：

?npm config get registry

應該輸出 https://registry.npmmirror.com。

如果想裝 cnpm 命令行工具也可以（非必需）：

?npm install -g cnpm --registry=https://registry.npmmirror.com

六、常見問題與解決

6.1 安裝后 node 命令找不到

現(xiàn)象：

?'node' 不是內部或外部命令，也不是可運行的程序

排查步驟：

1. 確認 D:\NodeJs\Node 已加入系統(tǒng) PATH
2. 關掉當前命令行窗口，新開一個再試（環(huán)境變量不會自動刷新）
3. 如果還不行，重啟電腦

6.2 能找到 node 但無法運行

現(xiàn)象：

?程序"node"無法運行: 找不到應用程序所在位置

或者用 where.exe node 看到輸出類似：

?C:\Windows\System32\node ? ? ? ← 一個假文件排在前面
?D:\NodeJs\Node\node.exe ? ? ?  ← 真正的 node

原因： C:\Windows\System32 里有一個叫 node 的 0 字節(jié)空文件（可能是某個程序卸載后的殘留，或 Windows 應用執(zhí)行別名），它在 PATH 中的搜索優(yōu)先級比你裝的 Node 高。

解決： 用管理員 PowerShell 刪掉它：

?Remove-Item C:\Windows\System32\node -Force

6.3 npm 全局安裝的包找不到命令

現(xiàn)象： 比如執(zhí)行 npm install -g yarn 成功，但敲 yarn 報找不到命令。

原因： npm 全局模塊目錄沒在 PATH 里。

解決： 確認 D:\NodeJs\Node\node_global 已加入系統(tǒng) PATH。

6.4 npm install 報權限錯誤（Error: EPERM）

現(xiàn)象：

?Error: EPERM: operation not permitted

解決： 用管理員身份打開命令行再執(zhí)行，或者前面已經(jīng)配置了把全局路徑改到 D 盤的話一般不會遇到這個問題。

6.5 安裝時提示 2502 / 2503 錯誤

現(xiàn)象： 運行 .msi 安裝包時報 2502 或 2503 錯誤。

解決： 用管理員身份運行安裝包。右鍵 .msi 文件 → 以管理員身份運行?；蛘哂霉芾韱T CMD 執(zhí)行：

?msiexec /package "你下載的安裝包路徑.msi"

七、版本管理工具（進階）

如果你需要在不同項目間切換 Node.js 版本，可以考慮裝一個版本管理器：

• nvm-windows： https://github.com/coreybutler/nvm-windows
• fnm： https://github.com/Schniz/fnm （跨平臺，更快）

裝好 nvm 后可以自由切換版本：

?nvm install 22.20.0 ? ?  # 安裝指定版本
?nvm use 22.20.0 ? ? ? ? ? # 切換到指定版本
?nvm list ? ? ? ? ? ? ? ?  # 查看已安裝的版本

總結

步驟不復雜，記住幾個關鍵點：

1. 去官網(wǎng)下 LTS 版本，網(wǎng)速慢就用國內鏡像
2. 安裝路徑別放 C 盤，記得勾選 "Add to PATH"
3. 裝完改 npm 的全局路徑和緩存路徑到非 C 盤
4. 國內用戶一定要配淘寶鏡像，不然下載等到天荒地老
5. 遇到 node 命令詭異報錯，先 where.exe node 排查是不是被假文件劫持了

以上就是Windows下Node.js安裝與配置的完全指南的詳細內容，更多關于Windows下Node.js安裝與配置的資料請關注腳本之家其它相關文章！

最新評論