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,再也不用为环境问题头疼啦!

相关推荐
dongdonglele52119 小时前
ros2环境安装
windows
muinomarts20 小时前
【Windows挂载夸克网盘到本地 AList+Raidrive】
windows
Sharewinfo_BJ21 小时前
PowerBI 2026年1月功能更新|效率升级,体验再优化
windows·microsoft·powerbi
yaoxin52112321 小时前
314. Java Stream API - 使用 Collectors.partitioningBy() 分区元素
java·windows
云小逸1 天前
【windows核心编程】Windows GDI编程深度解析:从消息循环到双缓冲动画的完整实现
windows
奋斗羊羊1 天前
rocketmq 及依赖环境编译安装过程记录(windows)
windows·rocketmq
鲨辣椒100861 天前
Linux软件编程基石——基础指令使用
linux·windows·microsoft
云小逸1 天前
【Nmap 源码学习】深度解析:main.cc 入口函数详解
网络·windows·学习·nmap
郝学胜-神的一滴1 天前
Python美学的三重奏:深入浅出列表、字典与生成器推导式
开发语言·网络·数据结构·windows·python·程序人生·算法
牙牙要健康1 天前
【open3d】Windows 下编译 Open3D C++ 源码完整教程
开发语言·c++·windows