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

相关推荐
美酒没故事°1 天前
Open WebUI安装指南。搭建自己的自托管 AI 平台
人工智能·windows·ai
一个欠登儿程序员1 天前
在国产服务器上通过 Docker 部署 Windows 虚拟机
服务器·windows·docker
爱宇阳1 天前
WSL2 隔离 Windows PATH 实战指南
windows·环境变量
ALex_zry1 天前
C++模板元编程实战技巧
网络·c++·windows
I疯子1 天前
2026-04-08 打卡第 5 天
开发语言·windows·python
一个人旅程~1 天前
旧笔记本电脑安装win10精简版LTSB&win10LTSC&linuxmint作为三系统的操作指导书(以DELL n4020为例)
linux·windows·经验分享·电脑
开开心心就好1 天前
支持自定义名单的实用随机抽签工具
windows·计算机视觉·计算机外设·excel·散列表·启发式算法·csdn开发云
dyj0951 天前
OpenClaw小龙虾本地部署【Windows系统 + 接入飞书】
windows·飞书
CresCent_Charles1 天前
(已解决)踩坑记录:Windows 11安装pointops编译时报错
windows
skywalk81631 天前
Windows下安装编译安装Whisper-CPP:一个语音实现框架集和高性能推理模型
人工智能·windows·whisper