Windows下NVM保姆级指南:安装、切换版本、指定路径+淘宝镜像配置,一次搞定!

📌 前言:为什么需要 NVM?

做前端开发的你是否遇到过这些痛点?

✅ 老项目依赖 Node 12.x,新项目要求 Node 18.x,手动卸载安装太麻烦

✅ 官网下载 Node 速度慢,甚至出现证书过期报错

✅ 想把 Node 安装到非系统盘,却不知道怎么配置

今天这篇指南,带你用「nvm-windows」一站式解决以上问题,还附带淘宝镜像加速技巧!

🔧 一、安装前准备(必看!)

  1. 卸载旧 Node.js

    若已安装单独的 Node,需先卸载(控制面板→程序卸载),否则会与 nvm 冲突

  2. 检查环境变量

    卸载后删除系统变量中残留的NODE_PATH(避免干扰 nvm 配置)

  3. 准备安装路径

    建议创建无中文、无空格的文件夹,例如:

  • 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安装路径
例:D:\nvm] B --> C[选择Node symlink路径
例: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.3

nvm install 14.21.3  

\# 安装16.20.2

nvm install 16.20.2  

\# 切换到16.20.2

nvm use 16.20.2  

\# 验证当前版本

node -v  # 输出 v16.20.2

⚠️ 注意:切换版本必须以管理员身份 运行终端,否则会提示exit status 1

📍 五、指定自定义安装路径(进阶)

若想修改 Node 的存储位置,按以下步骤操作:

  1. 关闭所有终端,停止 Node 相关进程

  2. 编辑settings.txt,修改rootpath

    root: E:\dev\nvm-new # 新nvm路径(需手动创建)

    path: E:\dev\nvm-new\nodejs # 新符号链接路径

  3. 重启终端,执行nvm install <版本>,Node 会自动安装到新路径下的v<版本>文件夹

❌ 六、避坑指南(新手必看)

  1. 切换版本失败?

    → 检查是否用管理员身份打开终端,或删除path路径下的nodejs文件夹后重试

  2. 下载慢 / 失败?

    → 核对settings.txt的镜像地址,或手动访问https://npmmirror.com/mirrors/node/确认网络

  3. node -v 无反应?

    → 执行nvm use <版本>重新创建符号链接,或检查路径是否有中文 / 空格

  4. npm 安装依赖报错?

    → 执行npm cache clean --force,并确认npm config get registry配置正确

📝 总结

  1. 安装前务必卸载旧 Node,路径避免中文 / 空格

  2. 淘宝镜像需同时配置settings.txt和 npm 全局设置

  3. 切换版本必须用管理员身份运行终端

按照以上步骤操作,就能轻松在 Windows 上管理多版本 Node,再也不用为环境问题头疼啦!

相关推荐
_Aaron___17 小时前
List.subList() 返回值为什么不能强转成 ArrayList
数据结构·windows·list
magic3341656318 小时前
Springboot整合MinIO文件服务(windows版本)
windows·spring boot·后端·minio·文件对象存储
babytiger1 天前
windows中用wsl使用cuda
windows·wsl·cuda
Mr.45671 天前
Windows 11 右键菜单恢复 Windows 10 经典样式:3 种实用方法详解
windows
一勺-_-1 天前
安装Windows双系统的步骤
windows
sukalot1 天前
windows显示驱动开发-多监视器管理器(三)
windows·驱动开发
Java技术实践1 天前
JPA 用 List 入参在 @Query中报错 unexpected AST node: {vector}
数据结构·windows·list
wangqiaowq1 天前
ImmutableList.of() 是 Google Guava 库 提供的一个静态工厂方法,用于创建一个不可变的(immutable)列表。
开发语言·windows·python
小龙报1 天前
《算法每日一题(1)--- 连续因子》
c语言·开发语言·c++·windows·git·算法·visual studio
日日行不惧千万里1 天前
绕过微软联网账号限制:用本地用户安装 Windows 11 的最新 3 种方法
windows·microsoft