Windows下NVM保姆级指南:安装、切换版本、指定路径+淘宝镜像配置,一次搞定!
📌 前言:为什么需要 NVM?
做前端开发的你是否遇到过这些痛点?
✅ 老项目依赖 Node 12.x,新项目要求 Node 18.x,手动卸载安装太麻烦
✅ 官网下载 Node 速度慢,甚至出现证书过期报错
✅ 想把 Node 安装到非系统盘,却不知道怎么配置
今天这篇指南,带你用「nvm-windows」一站式解决以上问题,还附带淘宝镜像加速技巧!
🔧 一、安装前准备(必看!)
-
卸载旧 Node.js
若已安装单独的 Node,需先卸载(控制面板→程序卸载),否则会与 nvm 冲突
-
检查环境变量
卸载后删除系统变量中残留的
NODE_PATH
(避免干扰 nvm 配置) -
准备安装路径
建议创建无中文、无空格的文件夹,例如:
-
nvm 自身路径:
D:\nvm
-
Node 符号链接路径:
D:\nvm\nodejs
📥 二、下载并安装 nvm-windows
1. 下载安装包
访问官方仓库:nvm-windows/releases
👉 推荐下载「nvm-setup.exe」(图形化安装,自动配置环境变量)
2. 分步安装操作
graph LR
A[双击nvm-setup.exe] --> B[选择nvm安装路径<br>例:D:\nvm]
B --> C[选择Node symlink路径<br>例:D:\nvm\nodejs]
C --> D[点击Install完成安装]
3. 验证安装成功
以管理员身份打开 CMD/PowerShell,输入:
nvm version # 输出版本号即成功(如 1.1.11)
🚀 三、关键配置:淘宝镜像加速(核心!)
淘宝旧镜像registry.npm.taobao.org
已停用,需配置新地址npmmirror.com
,分两步配置:
1. 配置 nvm 镜像(加速 Node/npm 下载)
① 找到 nvm 安装目录下的settings.txt
(如D:\nvm\settings.txt
)
② 添加以下内容(完整配置示例):
root: D:\nvm # nvm自身路径(与安装时一致)path: D:\nvm\nodejs # Node符号链接路径node\_mirror: https://npmmirror.com/mirrors/node/ # Node镜像npm\_mirror: https://npmmirror.com/mirrors/npm/ # npm镜像
2. 配置 npm 全局镜像(加速依赖安装)
终端执行以下命令:
\# 清空旧缓存(避免证书过期残留问题)npm cache clean --force  \# 设置淘宝镜像npm config set registry https://registry.npmmirror.com  \# 验证配置npm config get registry # 输出上述地址即成功
🔄 四、使用 nvm 管理 Node 版本
1. 常用命令速查表
功能 | 命令 |
---|---|
查看可安装版本 | nvm list available |
安装指定版本 | nvm install 16.20.2 (LTS 版) |
切换版本 | nvm use 16.20.2 |
查看已安装版本 | nvm list (* 号为当前版本) |
卸载版本 | nvm uninstall 16.20.2 |
2. 实操示例:安装 Node 14.x + 切换 16.x
\# 安装14.21.3nvm install 14.21.3  \# 安装16.20.2nvm install 16.20.2  \# 切换到16.20.2nvm use 16.20.2  \# 验证当前版本node -v # 输出 v16.20.2
⚠️ 注意:切换版本必须以管理员身份运行终端,否则会提示exit status 1
📍 五、指定自定义安装路径(进阶)
若想修改 Node 的存储位置,按以下步骤操作:
-
关闭所有终端,停止 Node 相关进程
-
编辑
settings.txt
,修改root
和path
:
root: E:\dev\nvm-new # 新nvm路径(需手动创建)path: E:\dev\nvm-new\nodejs # 新符号链接路径
- 重启终端,执行
nvm install <版本>
,Node 会自动安装到新路径下的v<版本>
文件夹
❌ 六、避坑指南(新手必看)
-
切换版本失败?
→ 检查是否用管理员身份打开终端,或删除
path
路径下的nodejs
文件夹后重试 -
下载慢 / 失败?
→ 核对
settings.txt
的镜像地址,或手动访问https://npmmirror.com/mirrors/node/
确认网络 -
node -v 无反应?
→ 执行
nvm use <版本>
重新创建符号链接,或检查路径是否有中文 / 空格 -
npm 安装依赖报错?
→ 执行
npm cache clean --force
,并确认npm config get registry
配置正确
📝 总结
-
安装前务必卸载旧 Node,路径避免中文 / 空格
-
淘宝镜像需同时配置
settings.txt
和 npm 全局设置 -
切换版本必须用管理员身份运行终端
按照以上步骤操作,就能轻松在 Windows 上管理多版本 Node,再也不用为环境问题头疼啦!