需卸载现有Node.js并安装nvm-windows来管理多版本：先彻底清理残留、再以管理员身份安装nvm-windows、手动配置settings.txt强化路径、通过nvm install/use切换版本，注意权限、符号链接及防病毒软件干扰。
如果您在 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 观察其显示为 <SYMLINKD>；若显示为目录，说明 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。
