Windows 系统多版本 Node.js 共存指南：NVM 管理利器详解

Windows 系统多版本 Node.js 共存指南：NVM 管理利器详解

nvm管理工具下载地址: https://nvm.uihtm.com/doc/download-nvm.html
也可以去github上下载: https://github.com/coreybutler/nvm-windows/releases

一、为什么需要多版本 Node.js？

在开发中，不同项目可能依赖特定版本的 Node.js。例如：

‌旧项目维护‌：使用 Node.js 14.x 构建的老系统需兼容旧环境。
‌新特性尝鲜‌：体验 Node.js 20.x 的 ES Modules 或性能优化。
‌框架限制‌：如某些工具链强制要求 Node.js 16.x。
‌直接安装多个版本会导致冲突‌，而 ‌NVM（Node Version Manager）‌ 可完美解决这一问题。

二、NVM 安装与配置

1. 安装前的准备

‌卸载旧版 Node.js‌
通过 ‌控制面板 → 程序和功能‌ 彻底卸载，避免环境变量残留。

2. 下载与安装

‌下载地址上面已介绍
‌安装路径注意‌
选择 ‌无空格路径‌（如 D:\nvm），避免后续命令报错。
✅ 推荐路径：C:\Users<用户名>\AppData\Roaming\nvm（默认）。

3. 配置镜像加速

打开 NVM 安装目录下的 settings.txt，添加国内镜像源：

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

（此配置可显著提升下载速度！）

三、多版本 Node.js 管理实战

1. 常用命令速查表

命令	作用	示例
nvm list available	查看可安装版本	nvm list available
nvm install	安装指定版本	nvm install 22.15.0
nvm use	切换版本	nvm use 22.15.0
nvm list	查看已安装版本	nvm list
nvm uninstall	卸载版本	nvm uninstall 22.15.0
nvm on	开启node.js版本管理	nvm on
nvm off	关闭node.js版本管理	nvm off

2. 实战演示

‌场景‌：同时安装 16.15.0、18.20.5、22.15.0 三个版本。

#### 安装版本
nvm install 16.15.0
nvm install 18.20.5
nvm install 22.15.0

#### 切换至 18.20.5
nvm use 18.20.5

#### 验证当前版本
node -v  # 应输出 v18.20.5

3. 常见问题解决

• ‌权限不足‌

以 ‌管理员身份‌ 运行命令行工具（CMD/PowerShell）。

• ‌切换失败‌

检查安装路径是否含空格，或尝试重启终端。

• ‌镜像失效‌

更新 settings.txt 中的镜像地址（可尝试华为云、阿里云镜像）。

四、替代方案：手动管理（不推荐）

若坚持不使用 NVM，可手动操作：

1. 从 Node.js 官网 下载 ZIP 包，解压至独立目录（如 D:\nodejs\v18.20.5）。
2. 通过 ‌环境变量‌ 调整 Path 中的 Node.js 路径。

⚠️ 缺点：频繁修改环境变量易出错，且全局依赖需重复安装。

五、总结

使用 ‌NVM‌ 可实现以下优势：

• ‌一键切换‌：不同项目快速适配 Node.js 版本。 ‌
• 依赖隔离‌：各版本的全局模块互不干扰。 ‌
• 下载加速‌：国内镜像配置省时省力。

立即安装 NVM，告别版本冲突困扰！如有疑问，欢迎在评论区留言讨论～