前言

在Windows平臺(tái)升級(jí)Node.js，核心推薦兩種方式：官方安裝包覆蓋安裝（適合大多數(shù)用戶，操作簡(jiǎn)單）和nvm-windows多版本管理（適合需要頻繁切換版本的場(chǎng)景）。以下是詳細(xì)步驟及注意事項(xiàng)：

一、前置準(zhǔn)備：確認(rèn)當(dāng)前版本與需求

在升級(jí)前，先檢查當(dāng)前Node.js版本，避免不必要的升級(jí)：
打開(kāi)命令提示符（CMD）或PowerShell，執(zhí)行：

node -v  # 查看當(dāng)前Node.js版本
npm -v   # 查看當(dāng)前npm版本（升級(jí)Node.js通常會(huì)同步升級(jí)npm）

如果需要保留舊版本（如多項(xiàng)目依賴(lài)不同版本），優(yōu)先選擇nvm-windows；如果僅需升級(jí)到最新版本，可選擇官方安裝包。

二、方法1：官方安裝包覆蓋安裝（推薦新手）

步驟1：下載最新LTS版本安裝包

Node.js的**長(zhǎng)期支持版（LTS）**是生產(chǎn)環(huán)境的首選，穩(wěn)定性更高。

• 訪問(wèn)Node.js官網(wǎng)（https://nodejs.org/zh-cn/），點(diǎn)擊“長(zhǎng)期支持版”下載Windows安裝包（.msi格式，如node-v24.13.0-x64.msi，需匹配系統(tǒng)架構(gòu)：64位或32位）。
• 國(guó)內(nèi)用戶可使用鏡像站加速（如淘寶NPM鏡像：https://registry.npmmirror.com/mirrors/node/），下載對(duì)應(yīng)版本的.msi文件。

步驟2：運(yùn)行安裝包，覆蓋舊版本

雙擊下載的.msi文件，啟動(dòng)安裝向?qū)В?/p>

• 選擇“Upgrade”（升級(jí)）選項(xiàng)（若已安裝舊版，向?qū)?huì)自動(dòng)檢測(cè)到），跟隨向?qū)瓿砂惭b（默認(rèn)勾選“Add to PATH”，自動(dòng)配置環(huán)境變量）。
• 若需自定義安裝路徑，避免使用空格或中文（如D:\Develop\nodejs），防止后續(xù)命令執(zhí)行出錯(cuò)。

步驟3：驗(yàn)證升級(jí)結(jié)果

安裝完成后，重啟終端（或重新打開(kāi)CMD），執(zhí)行：

node -v  # 應(yīng)顯示最新LTS版本（如v24.13.0）
npm -v   # 應(yīng)顯示對(duì)應(yīng)npm版本（如10.5.0）

若版本未更新，需檢查環(huán)境變量（是否指向新安裝的Node.js目錄）或重啟電腦。

三、方法2：nvm-windows多版本管理（適合多項(xiàng)目場(chǎng)景）

nvm-windows（Node Version Manager for Windows）是Windows下的Node.js版本管理工具，可同時(shí)安裝多個(gè)Node.js版本，并快速切換。

步驟1：卸載舊版本Node.js

為避免版本沖突，需先卸載已安裝的Node.js：

• 通過(guò)控制面板→“程序和功能”，找到“Node.js”，右鍵卸載；
• 刪除殘留文件（如C:\Program Files\nodejs、%AppData%\npm），并清理環(huán)境變量中的Node.js路徑。

步驟2：安裝nvm-windows

• 下載nvm-windows安裝包：推薦從GitHub官方倉(cāng)庫(kù)（https://github.com/coreybutler/nvm-windows/releases）下載nvm-setup.exe（安裝版，無(wú)需手動(dòng)配置環(huán)境變量）。
• 運(yùn)行nvm-setup.exe，按向?qū)瓿砂惭b：
  • NVM安裝路徑：建議選擇無(wú)空格、無(wú)中文的目錄（如D:\Develop\VerManage\nvm）；
  • Node.js符號(hào)鏈接目錄：默認(rèn)C:\Program Files\nodejs（需與后續(xù)環(huán)境變量配置一致）；
  • 勾選“Add to PATH”（自動(dòng)添加nvm環(huán)境變量）。

步驟3：配置國(guó)內(nèi)鏡像源（加速下載）

nvm默認(rèn)從國(guó)外服務(wù)器下載Node.js，速度較慢。需配置國(guó)內(nèi)鏡像（如淘寶源）：

• 打開(kāi)nvm安裝目錄（如D:\Develop\VerManage\nvm），找到settings.txt文件（若不存在則新建）；
• 添加以下內(nèi)容：

  node_mirror: https://npmmirror.com/mirrors/node/
  npm_mirror: https://npmmirror.com/mirrors/npm/

步驟4：安裝與切換Node.js版本

打開(kāi)CMD（或PowerShell），執(zhí)行以下命令：

nvm list available  # 查看所有可安裝的Node.js版本（偶數(shù)為L(zhǎng)TS穩(wěn)定版）
nvm install lts      # 安裝最新LTS版本（推薦）
nvm install 22.12.0  # 安裝指定版本（如22.12.0）
nvm list            # 查看已安裝的版本（帶*的為當(dāng)前使用的版本）
nvm use 24.13.0     # 切換到指定版本（需管理員權(quán)限，若出現(xiàn)“exit status 1”，右鍵CMD選擇“以管理員身份運(yùn)行”）

步驟5：驗(yàn)證版本與全局模塊

• 執(zhí)行node -v和npm -v，確認(rèn)版本正確；
• 配置全局模塊路徑（避免權(quán)限問(wèn)題）：
  在nvm安裝目錄下新建node_global和node_cache文件夾（如D:\Develop\VerManage\nvm\node_global），然后執(zhí)行：

  npm config set prefix "D:\Develop\VerManage\nvm\node_global"
  npm config set cache "D:\Develop\VerManage\nvm\node_cache"
  

  并將D:\Develop\VerManage\nvm\node_global添加到系統(tǒng)環(huán)境變量的Path中（確保全局安裝的模塊可被識(shí)別）。

四、常見(jiàn)問(wèn)題解決

1. 權(quán)限錯(cuò)誤：執(zhí)行nvm use或npm install -g時(shí)提示“權(quán)限不足”，需以管理員身份運(yùn)行CMD（右鍵→“以管理員身份運(yùn)行”）。
2. 版本未更新：檢查環(huán)境變量是否指向正確的Node.js目錄（如C:\Program Files\nodejs），或重啟電腦使環(huán)境變量生效。
3. 安裝失敗：確保已卸載舊版本Node.js，且安裝路徑無(wú)空格或中文；若使用nvm，檢查settings.txt中的鏡像源是否正確。
4. 全局模塊丟失：升級(jí)Node.js后，全局安裝的模塊（如express）需重新安裝（npm install -g express），或通過(guò)nvm reinstall-packages <version>恢復(fù)（僅nvm支持）。

五、總結(jié)

• 官方安裝包：適合新手或僅需單一版本的場(chǎng)景，操作簡(jiǎn)單，自動(dòng)覆蓋舊版本；
• nvm-windows：適合多項(xiàng)目開(kāi)發(fā)或需要頻繁切換版本的場(chǎng)景，可隔離不同版本的Node.js環(huán)境，避免版本沖突。

無(wú)論選擇哪種方式，升級(jí)前需備份重要項(xiàng)目（如package.json、node_modules），并檢查項(xiàng)目的engines字段（確保新版本兼容）：

{
  "engines": {
    "node": ">=18.0.0"  // 項(xiàng)目支持的Node.js版本范圍
  }
}

提示：Node.js的LTS版本（如v24.x、v22.x）每2年發(fā)布一次，支持周期長(zhǎng)達(dá)3年，適合生產(chǎn)環(huán)境；Current版本（如v25.x）包含最新特性，但穩(wěn)定性較低，適合開(kāi)發(fā)測(cè)試。建議優(yōu)先選擇LTS版本。

到此這篇關(guān)于Windows平臺(tái)升級(jí)Node.js詳細(xì)步驟及注意事項(xiàng)的文章就介紹到這了,更多相關(guān)Windows升級(jí)Node.js內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論