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

news2025/4/30 0:47:52

🧑 博主简介：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环境

控制面板卸载
[Win+R] → 输入appwiz.cpl → 打开卸载程序窗口—>找到Node.js条目 → 右键卸载
或 控制面板 -> 卸载程序 -> 卸载nodejs
如下：
手动清理残留文件
删除以下目录（需显示隐藏文件）：
```
C:\Program Files (x86)\Nodejs
C:\Program Files\Nodejs
C:\Users\{用户名}\AppData\Roaming\npm
C:\Users\{用户名}\AppData\Roaming\npm-cache
```
如果node.js是安装在其他路径下的，也需要找到并删除。

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

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

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

验证卸载结果
CMD执行：

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

在这里插入图片描述

二、安装NVM管理器

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

安装过程：

在这里插入图片描述
经过以上步骤，nvm已安装完成。

安装注意事项
- Node.js路径需在nvm目录下（如D:\Program Files\nvm\nodejs）
- 关闭杀毒软件防止误拦截

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

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

在这里插入图片描述

三、环境变量配置

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

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

在这里插入图片描述

手动补充配置

用户变量Path：

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

在这里插入图片描述

系统变量 → 新建：

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

在这里插入图片描述

系统变量path:
在这里插入图片描述

验证安装
CMD执行：
```
nvm -v # 显示版本号即成功
```

在这里插入图片描述

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

安装指定版本

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

在这里插入图片描述

版本切换命令
```
nvm list # 查看已安装版本
```

在这里插入图片描述

nvm use 18.20.4 # 切换到指定版本

在这里插入图片描述

全局模块路径配置

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

镜像加速验证

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

五、开发环境验证

基础功能测试

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

多版本切换测试

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

在这里插入图片描述

常见问题排查

安装失败提示Exit code 1
- 确认安装路径无中文
- 检查settings.txt镜像配置
- 删除C:\Program Files\nodejs残留
切换版本后命令不可用
以管理员身份运行CMD执行：
```
nvm on
nvm root D:\Program Files\nvm # 重置安装路径
```