Windows升级Node.js教程：官方安装与nvm-windows双方案详解

前言

针对Windows环境升级Node.js，主要推荐两种方案：使用官方安装包进行覆盖安装（适用于大多数用户，操作简便）以及采用nvm-windows进行多版本管理（适用于需要频繁切换版本的场景）。具体操作步骤与注意事项如下：

一、升级前的准备工作：核实当前版本与需求

在实施升级前，务必检查当前Node.js的版本信息，以避免不必要的升级操作：打开命令提示符（CMD）或PowerShell终端，输入以下命令：

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），并执行：

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文件（若不存在则新建）；

添加以下内容：

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

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

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

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），然后执行：
```
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字段（确保新版本兼容）：

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

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

到此这篇关于Windows平台升级Node.js详细步骤及注意事项的文章就介绍到这了,更多相关Windows升级Node.js内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站！

Windows平台升级Node.js详细步骤及注意事项

前言