Windows平台升级Node.js

在Windows平台升级Node.js，核心推荐两种方式 ：官方安装包覆盖安装 （适合大多数用户，操作简单）和nvm-windows多版本管理（适合需要频繁切换版本的场景）。以下是详细步骤及注意事项：

一、前置准备：确认当前版本与需求

在升级前，先检查当前Node.js版本，避免不必要的升级：

打开命令提示符（CMD）或PowerShell，执行：

bash 复制代码

node -v  # 查看当前Node.js版本
npm -v   # 查看当前npm版本（升级Node.js通常会同步升级npm）

如果需要保留旧版本 （如多项目依赖不同版本），优先选择nvm-windows ；如果仅需升级到最新版本，可选择官方安装包。

二、方法1：官方安装包覆盖安装（推荐新手）

步骤1：下载最新LTS版本安装包

Node.js的**长期支持版（LTS）**是生产环境的首选，稳定性更高。

访问Node.js官网（https://nodejs.org/zh-cn/），点击"长期支持版"下载Windows安装包（`.msi`格式，如`node-v24.13.0-x64.msi`，需匹配系统架构：64位或32位）。
国内用户可使用镜像站加速 （如淘宝NPM镜像：https://registry.npmmirror.com/mirrors/node/），下载对应版本的`.msi`文件。

步骤2：运行安装包，覆盖旧版本

双击下载的.msi文件，启动安装向导：

选择"Upgrade"（升级）选项（若已安装旧版，向导会自动检测到），跟随向导完成安装（默认勾选"Add to PATH"，自动配置环境变量）。
若需自定义安装路径，避免使用空格或中文 （如D:\Develop\nodejs），防止后续命令执行出错。

步骤3：验证升级结果

安装完成后，重启终端（或重新打开CMD），执行：

bash 复制代码

node -v  # 应显示最新LTS版本（如v24.13.0）
npm -v   # 应显示对应npm版本（如10.5.0）

若版本未更新，需检查环境变量 （是否指向新安装的Node.js目录）或重启电脑。

三、方法2：nvm-windows多版本管理（适合多项目场景）

nvm-windows（Node Version Manager for Windows）是Windows下的Node.js版本管理工具，可同时安装多个Node.js版本，并快速切换。

步骤1：卸载旧版本Node.js

为避免版本冲突，需先卸载已安装的Node.js：

通过控制面板→"程序和功能"，找到"Node.js"，右键卸载；
删除残留文件（如C:\Program Files\nodejs、%AppData%\npm），并清理环境变量中的Node.js路径。

步骤2：安装nvm-windows

下载nvm-windows安装包：推荐从GitHub官方仓库（https://github.com/coreybutler/nvm-windows/releases）下载`nvm-setup.exe`（安装版，无需手动配置环境变量）。
运行nvm-setup.exe，按向导完成安装：
- NVM安装路径 ：建议选择无空格、无中文的目录（如D:\Develop\VerManage\nvm）；
- Node.js符号链接目录 ：默认C:\Program Files\nodejs（需与后续环境变量配置一致）；
- 勾选"Add to PATH"（自动添加nvm环境变量）。

步骤3：配置国内镜像源（加速下载）

nvm默认从国外服务器下载Node.js，速度较慢。需配置国内镜像（如淘宝源）：

打开nvm安装目录（如D:\Develop\VerManage\nvm），找到settings.txt文件（若不存在则新建）；

添加以下内容：

txt 复制代码

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

步骤4：安装与切换Node.js版本

打开CMD（或PowerShell），执行以下命令：

bash 复制代码

nvm list available  # 查看所有可安装的Node.js版本（偶数为LTS稳定版）
nvm install lts      # 安装最新LTS版本（推荐）
nvm install 22.12.0  # 安装指定版本（如22.12.0）
nvm list            # 查看已安装的版本（带*的为当前使用的版本）
nvm use 24.13.0     # 切换到指定版本（需管理员权限，若出现"exit status 1"，右键CMD选择"以管理员身份运行"）

步骤5：验证版本与全局模块

执行node -v和npm -v，确认版本正确；
配置全局模块路径 （避免权限问题）：
在nvm安装目录下新建node_global和node_cache文件夹（如D:\Develop\VerManage\nvm\node_global），然后执行：
bash 复制代码
```
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添加到系统环境变量 的Path中（确保全局安装的模块可被识别）。

四、常见问题解决

权限错误 ：执行nvm use或npm install -g时提示"权限不足"，需以管理员身份运行CMD（右键→"以管理员身份运行"）。
版本未更新 ：检查环境变量是否指向正确的Node.js目录（如C:\Program Files\nodejs），或重启电脑使环境变量生效。
安装失败 ：确保已卸载旧版本Node.js，且安装路径无空格或中文；若使用nvm，检查settings.txt中的镜像源是否正确。
全局模块丢失 ：升级Node.js后，全局安装的模块（如express）需重新安装（npm install -g express），或通过nvm reinstall-packages <version>恢复（仅nvm支持）。

五、总结

官方安装包 ：适合新手或仅需单一版本的场景，操作简单，自动覆盖旧版本；
nvm-windows ：适合多项目开发 或需要频繁切换版本的场景，可隔离不同版本的Node.js环境，避免版本冲突。

无论选择哪种方式，升级前需备份重要项目 （如package.json、node_modules），并检查项目的engines字段（确保新版本兼容）：

json 复制代码

{
  "engines": {
    "node": ">=18.0.0"  // 项目支持的Node.js版本范围
  }
}

提示：Node.js的LTS版本（如v24.x、v22.x）每2年发布一次，支持周期长达3年，适合生产环境；Current版本（如v25.x）包含最新特性，但稳定性较低，适合开发测试。建议优先选择LTS版本。