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

相关推荐
木木子99993 小时前
Python的typing模块:类型提示 (Type Hinting)
开发语言·windows·python
馨羽的玩具6 小时前
Windows系统安装arm麒麟系统
arm开发·windows
YCOSA20259 小时前
26X00.6588_GE_RELEASE_SVC_IM.250918-1932_CLIENT_IOT_LTSC_OEM_X64FRE_ZH-CN.iso
windows
monkeySix10 小时前
chrome-devtools-mcp windows 环境安装
windows
canonical-entropy10 小时前
NopReport示例-动态Sheet和动态列
java·windows·可逆计算·nop平台·报表引擎
LB211210 小时前
苍穹外卖-菜品新增、删除
java·服务器·windows
angushine1 天前
Windows版本PostgreSQL定时备份
数据库·windows·postgresql
"菠萝"1 天前
C#知识学习-015(修饰符_4)
开发语言·windows·c#
诗句藏于尽头1 天前
关于七牛云OSS存储的图片数据批量下载到本地
开发语言·windows·python