NVM 多版本Node.js 管理全指南（Windows系统）

🧑 博主简介：CSDN博客专家、全栈领域优质创作者、高级开发工程师、高级信息系统项目管理师、系统架构师，数学与应用数学专业，10年以上多种混合语言开发经验，从事DICOM医学影像开发领域多年，熟悉DICOM协议及其应用开发技术。我的技能涵盖了多种编程语言和技术框架：作为高级C/C++与C#开发工程师，擅长Windows系统下的.NET及C++开发技术，尤其精通MFC、DLL动态链接库、WinForm、WPF、Windows服务、WebAPI及.NET Core跨平台等技术的开发工作。熟悉Java开发，并利用业余时间学习了JavaScript、Vue等前端技术，同时自学了QT开发工具，对Python开发也有一定的了解，因此使我具备了使用多种混合语言进行开发的能力。我一直坚持撰写博客文章，记录个人的学习历程，分享编程开发相关的知识与经验，旨在为编程爱好者提供帮助和支持。通过这样的方式，我希望可以与志同道合的朋友交流探讨，共同进步，在技术的世界里不断学习和成长。如果您也热衷于技术探索，愿意一起讨论最新技术趋势或解决遇到的技术难题，欢迎随时联系。让我们携手共进，在追求卓越技术的道路上越走越远。欢迎关注、学习及合作，可提供解决方案和技术支持！
技术合作请加本人wx（注明来自csdn）：xt20160813

NVM多版本Node.js管理全指南（Windows系统）

---

前言

随着项目迭代升级，开发者常需在不同Node版本间切换（如旧项目使用Node 12.x，新项目使用18.x，22.x等高版本）。传统卸载重装方式效率低下，NVM（Node Version Manager）可完美实现多版本管理。本教程将详解Windows平台下的完整配置流程。

---

一、彻底卸载现有Node.js环境

1. 控制面板卸载
   [Win+R] → 输入appwiz.cpl → 打开卸载程序窗口—>找到Node.js条目 → 右键卸载
   或 控制面板 -> 卸载程序 -> 卸载nodejs
   如下：

2. 手动清理残留文件
   删除以下目录（需显示隐藏文件）：

   C:\Program Files (x86)\Nodejs
   C:\Program Files\Nodejs
   C:\Users\{用户名}\AppData\Roaming\npm
   C:\Users\{用户名}\AppData\Roaming\npm-cache
   

   如果node.js是安装在其他路径下的，也需要找到并删除。

3. 删除配置文件
   删除用户目录下的：

   C:\Users\{用户名}\.npmrc
   C:\Users\{用户名}\.yarnrc
   

4. 清除环境变量
   [Win+S] → 搜索"环境变量" → 删除Path中所有包含node、npm的条目
   环境变量中npm、node的所有相关的都删除干净

5. 验证卸载结果
   CMD执行：

   node -v # 应提示"不是内部命令"
   where node # 无返回结果
   

---

二、安装NVM管理器

1. 下载安装包
   访问GitHub仓库下载最新版：
   https://github.com/coreybutler/nvm-windows/releases
   
   安装过程：
   
   
   
   

经过以上步骤，nvm已安装完成。

2. 安装注意事项

   • Node.js路径需在nvm目录下（如D:\Program Files\nvm\nodejs）
   • 关闭杀毒软件防止误拦截

3. 镜像加速配置
   打开settings.txt（路径：D:\nvm\settings.txt）添加：

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

---

三、环境变量配置

1. 自动生成变量
   成功安装后会自动添加：

   NVM_HOME = D:\Program Files\nvm
   NVM_SYMLINK = D:\Program Files\nvm\nodejs
   

   

2. 手动补充配置

   • 用户变量Path：

     %NVM_HOME%
     %NVM_SYMLINK%
     D:\Program Files\nvm\node_globa
     

     

   • 系统变量 → 新建：

     NODE_PATH = D:\Program Files\nvm\node_global\node_modules
     

     

     系统变量path:
     

3. 验证安装
   CMD执行：

   nvm -v # 显示版本号即成功
   

---

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

1. 安装指定版本

   nvm install 14.17.0 # 安装14.17.0版本
   nvm install 22.14.0 # 安装22.14.0版本
   

   

2. 版本切换命令

   nvm list # 查看已安装版本
   

nvm use 18.20.4 # 切换到指定版本

3. 全局模块路径配置

   npm config set prefix "D:\Program Files\nvm\node_global"
   npm config set cache "D:\Program Files\nvm\node_cache"
   

4. 镜像加速验证

   npm config get registry # 应返回淘宝镜像地址
   

---

五、开发环境验证

1. 基础功能测试

   node -v # 显示当前版本
   npm -g install express # 全局安装测试
   where express # 查看模块路径
   

2. 多版本切换测试

   nvm use 14
   node -v # 应显示14.17.0
   nvm use 22
   node -v # 应显示22.14.0
   

---

常见问题排查

1. 安装失败提示Exit code 1

   • 确认安装路径无中文
   • 检查settings.txt镜像配置
   • 删除C:\Program Files\nodejs残留

2. 切换版本后命令不可用
   以管理员身份运行CMD执行：

   nvm on
   nvm root D:\Program Files\nvm # 重置安装路径
   

---

通过本教程，您已掌握：
✅ 纯净卸载Node环境
✅ NVM多版本管理技巧
✅ 镜像加速与路径配置
✅ 开发环境深度验证
建议将D:\Program Files\nvm\node_global加入杀毒软件白名单，确保开发环境稳定运行。