Win10下NVM管理Node版本教程

如果你正在 Windows 10 上被 Node.js 多版本共存问题困扰——项目依赖不同版本却频频报错、npm 全局包混乱、环境无法复现，那么这篇指南正是为你量身定制的实战手册：它手把手教你彻底卸载旧版 Node、用 nvm-windows 安全安装与隔离多个版本，并通过管理员权限配置、符号链接修复、防病毒软件规避及 settings.txt 精准控制等关键步骤，确保每次 `nvm use` 都稳定生效；无论你是前端开发者、全栈工程师还是 CI/CD 环境搭建者，都能借此实现真正可靠、可重复、跨项目的 Node.js 版本自由切换。

如果您在 Windows 10 系统中需要灵活切换多个 Node.js 版本以适配不同项目，但当前仅安装了单一全局 Node.js，则可能面临版本冲突、npm 包隔离失效或环境不可复现等问题。以下是针对 Win10 平台使用 nvm-windows 管理 Node.js 版本的完整操作路径：

一、彻底卸载现有 Node.js 及残留项

安装 nvm-windows 前必须清除所有 Node.js 相关痕迹，否则将导致路径覆盖、符号链接失败或命令冲突。残留未清会导致 nvm install 后无法识别、nvm use 无响应等静默故障。

1、通过「控制面板 → 程序和功能」卸载所有名称含 "Node.js" 的条目。

2、手动删除以下目录（若存在）：C:\Program Files\nodejs、C:\Program Files (x86)\nodejs、C:\Users\用户名\AppData\Roaming\npm、C:\Users\用户名\AppData\Roaming\npm-cache。

3、删除用户根目录下的隐藏配置文件：C:\Users\用户名\.npmrc、C:\Users\用户名\.yarnrc。

4、右键「此电脑 → 属性 → 高级系统设置 → 环境变量」，在「用户变量」和「系统变量」的 Path 中删除所有含 nodejs 或 npm 的条目；同时删除系统变量中名为 NODE_PATH 的变量。

5、以管理员身份打开 PowerShell，执行：node -v 与 npm -v，确认均返回“不是内部或外部命令”；重启系统确保环境变量完全刷新。

二、安装 nvm-windows 的两种可靠方式

nvm-windows 是专为 Windows 设计的独立实现，不兼容 Linux/macOS 的 nvm.sh 脚本。必须使用其官方发行版，且安装过程需管理员权限以写入系统环境变量和创建符号链接。

1、访问 GitHub Release 页面：https://github.com/coreybutler/nvm-windows/releases，下载最新 nvm-setup.zip（截至 2026 年 4 月为 v1.1.11）。

2、解压后以管理员身份运行 nvm-setup.exe。

3、安装向导中指定安装路径：C:\nvm（禁止空格、中文、特殊字符）；Node.js 符号链接路径设为：C:\nvm\nodejs（非默认 C:\Program Files\nodejs，避免 UAC 权限阻断）。

4、勾选「Add to PATH」，确保自动注入 %NVM_HOME% 与 %NVM_SYMLINK%。

5、安装完成后，关闭并重新打开命令提示符（非旧窗口），执行 nvm version 验证输出版本号；若报错，请检查环境变量中 Path 是否包含 %NVM_HOME% 和 %NVM_SYMLINK%。

三、手动配置 settings.txt 强化路径控制

当自动安装因权限或路径策略失败时，可通过手动配置 settings.txt 文件强制指定根目录与架构，规避默认路径解析错误及 32/64 位混用问题。

1、在 C:\nvm 目录下新建纯文本文件，命名为 settings.txt。

2、写入以下四行内容（严格区分大小写与冒号后空格）：
root: C:\nvm
path: C:\nvm\versions\node
arch: 64
proxy: none

3、以管理员身份运行 PowerShell，执行：setx NVM_HOME "C:\nvm" /M 和 setx NVM_SYMLINK "C:\nvm\nodejs" /M。

4、再次执行 setx Path "%Path%;%NVM_HOME%;%NVM_SYMLINK%" /M，然后重启终端。

四、版本安装与切换的标准流程

nvm-windows 通过下载预编译二进制包完成安装，不编译源码，因此依赖网络连通性与微软签名验证。切换操作本质是更新符号链接指向，需确保目标版本已成功安装且磁盘空间充足。

1、执行 nvm list available 查看可安装版本列表（LTS 标注为 lts，如 lts/gallium）。

2、安装指定版本（示例安装 LTS 版本）：nvm install lts/gallium；或安装具体版本：nvm install 20.18.0。

3、安装完成后执行 nvm list，确认版本号前无星号（*）表示尚未激活。

4、执行 nvm use 20.18.0 切换当前 Shell 会话的 Node.js 环境；该操作仅对当前命令行窗口生效。

5、验证切换结果：node -v 应输出 v20.18.0，npm -v 应输出对应捆绑的 npm 版本（如 10.9.2）。

五、关键注意事项与避坑要点

nvm-windows 在 Win10 上的行为受系统策略、UAC、防病毒软件及 PowerShell 执行策略共同影响。忽略以下任一条件均可能导致命令无响应、版本丢失或 npm 全局模块不可见。

1、所有 nvm 命令（包括 install、use、list）必须在以管理员身份运行的命令提示符或 PowerShell 中执行；普通用户窗口无法创建符号链接。

2、C:\nvm\nodejs 必须为符号链接而非普通文件夹，可通过 dir C:\nvm 观察其显示为 ；若显示为目录，说明 nvm use 失败。

3、禁用 Windows Defender 实时保护或添加 C:\nvm 为排除项，否则可能拦截 nvm 下载的 node.exe 并触发“已删除”假阳性。

4、Git Bash 或 Windows Terminal 中若使用 WSL 子系统，nvm-windows 不对其生效；WSL 内需单独安装 Linux 版 nvm。

5、每次新开命令行窗口，Node.js 版本均恢复为系统默认（即未 use 状态），需重复执行 nvm use x.x.x；如需持久化，默认版本可设为：nvm alias default 20.18.0。

理论要掌握，实操不能落！以上关于《Win10下NVM管理Node版本教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！