前言

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

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

一、什么是 Node.js

簡(jiǎn)單說，Node.js 是一個(gè)基于 Chrome V8 引擎的 JavaScript 運(yùn)行時(shí)，讓你能在瀏覽器之外跑 JS 代碼。

裝好 Node.js 之后你會(huì)同時(shí)獲得兩個(gè)命令行工具：

• node — 運(yùn)行 JavaScript 的運(yùn)行時(shí)
• npm — Node 包管理器，用來安裝第三方庫

二、下載安裝包

版本選擇

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

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

國(guó)內(nèi)鏡像加速下載

官網(wǎng)下載在國(guó)內(nèi)有時(shí)候很慢，可以用國(guó)內(nèi)鏡像：

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

選對(duì)應(yīng)的大版本號(hào)（如 v22.20.0/），下載 node-v22.20.0-x64.msi 或 node-v22.20.0-x64.zip。

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

三、安裝步驟

3.1 運(yùn)行安裝程序

雙擊下載好的 .msi 文件，進(jìn)入安裝向?qū)А?/p>

3.2 接受許可協(xié)議

勾選 "I accept the terms in the License Agreement"，點(diǎn) Next。

3.3 選擇安裝路徑

重點(diǎn)：不要用默認(rèn)的 C 盤路徑。

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

?D:\NodeJs\Node

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

3.4 選擇安裝組件

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

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

3.5 自動(dòng)安裝工具（可選）

安裝到最后一步會(huì)彈出一個(gè)復(fù)選框，問你要不要自動(dòng)安裝 Chocolatey 等額外工具。

勾掉，不需要。 直接點(diǎn) Finish 完成安裝。

四、驗(yàn)證安裝

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

?node --version

預(yù)期輸出類似：

?v22.20.0

再驗(yàn)證 npm：

?npm --version

預(yù)期輸出類似：

?10.9.0

如果兩個(gè)命令都能正常輸出版本號(hào)，說明安裝成功了。

五、配置 npm

5.1 修改全局模塊安裝路徑

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

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

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

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

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

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

然后在命令行里設(shè)置：

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

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

5.2 把新的 global 路徑加入 PATH

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

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

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

順便把 D:\NodeJs\Node 也確認(rèn)在 PATH 里。

5.3 配置淘寶鏡像（國(guó)內(nèi)必備）

npm 默認(rèn)去 registry.npmjs.org 拉包，國(guó)內(nèi)下載容易超時(shí)或極慢。換成國(guó)內(nèi)鏡像：

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

驗(yàn)證是否生效：

?npm config get registry

應(yīng)該輸出 https://registry.npmmirror.com。

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

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

六、常見問題與解決

6.1 安裝后 node 命令找不到

現(xiàn)象：

?'node' 不是內(nèi)部或外部命令，也不是可運(yùn)行的程序

排查步驟：

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

6.2 能找到 node 但無法運(yùn)行

現(xiàn)象：

?程序"node"無法運(yùn)行: 找不到應(yīng)用程序所在位置

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

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

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

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

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

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

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

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

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

6.4 npm install 報(bào)權(quán)限錯(cuò)誤（Error: EPERM）

現(xiàn)象：

?Error: EPERM: operation not permitted

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

6.5 安裝時(shí)提示 2502 / 2503 錯(cuò)誤

現(xiàn)象： 運(yùn)行 .msi 安裝包時(shí)報(bào) 2502 或 2503 錯(cuò)誤。

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

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

七、版本管理工具（進(jìn)階）

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

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

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

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

總結(jié)

步驟不復(fù)雜，記住幾個(gè)關(guān)鍵點(diǎn)：

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

以上就是Windows下Node.js安裝與配置的完全指南的詳細(xì)內(nèi)容，更多關(guān)于Windows下Node.js安裝與配置的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論