Win11多版本Node.js切换方法详解

本文详细讲解了在Windows 11系统中实现多版本Node.js无缝切换的完整实战流程：从彻底卸载旧环境、清理残留文件与环境变量，到安装配置国内加速的nvm-windows管理器，再到并行安装多个LTS及稳定版Node.js、按项目灵活切换版本，最后覆盖常见故障（如命令不可用、npm路径错乱、下载失败等）的精准排查与修复方案，手把手解决开发者长期困扰的版本冲突与环境混乱问题，让Node.js多版本管理变得稳定、高效且开箱即用。

一、彻底卸载现有Node.js环境

若系统中已单独安装Node.js，nvm-windows在初始化时会检测到残留路径并拒绝接管或切换失败。必须清除所有Node.js相关组件，包括程序本体、全局npm包、缓存及环境变量条目，才能确保nvm后续操作稳定可靠。

1、打开“设置”→“应用”→“已安装的应用”，搜索“Node”，对所有匹配项执行卸载。

2、以管理员身份运行PowerShell，逐行执行以下命令删除残留目录：

Remove-Item -Path "C:\Program Files\nodejs" -Recurse -Force -ErrorAction SilentlyContinue

Remove-Item -Path "C:\Program Files (x86)\nodejs" -Recurse -Force -ErrorAction SilentlyContinue

Remove-Item -Path "$env:APPDATA\npm" -Recurse -Force -ErrorAction SilentlyContinue

Remove-Item -Path "$env:APPDATA\npm-cache" -Recurse -Force -ErrorAction SilentlyContinue

3、右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”和“用户变量”的PATH中，手动删除所有含nodejs或npm字样的路径条目。

4、重启计算机，随后在CMD中运行where node，若无任何输出，表明清理完成。

二、安装nvm-windows并配置国内镜像源

nvm-windows是Windows平台专用版本管理器，不依赖WSL或PowerShell模块，通过批处理脚本动态修改PATH实现版本隔离。安装前必须使用纯净路径（无空格、无中文），并启用淘宝/npmmirror镜像以规避下载超时。

1、访问GitHub官方发布页：https://github.com/coreybutler/nvm-windows/releases，下载最新版nvm-setup.exe（如v1.1.12）。

2、双击运行安装包，第一步选择nvm安装路径（推荐D:\nvm）；第二步设置Node.js软链接路径（推荐D:\nodejs），两处均不得含空格或中文字符。

3、安装完成后，进入nvm安装目录（如D:\nvm），用记事本打开settings.txt文件，在末尾新增两行：

node_mirror: https://npmmirror.com/mirrors/node/

npm_mirror: https://npmmirror.com/mirrors/npm/

4、关闭所有终端窗口，重新以管理员身份打开PowerShell，运行nvm --version，输出版本号即表示安装与镜像配置成功。

三、安装多个Node.js版本并导入已有版本

nvm支持并行安装任意数量的Node.js主版本，每个版本独立存放于nvm目录下的vX.X.X子文件夹中，拥有专属的node.exe、npm.cmd及全局node_modules空间，避免跨版本包冲突。

1、运行nvm list available，查看所有可安装版本，重点关注标有LTS字样的长期支持版本（如16.20.2、18.20.4、20.11.1）。

2、安装新版本，例如：

nvm install 18.20.4

nvm install 20.11.1

3、若原有v16.14.2仍需保留，先运行where node获取其安装路径（如C:\Program Files\nodejs），再执行：

nvm install 16.14.2 "C:\Program Files\nodejs"

4、运行nvm list，确认输出中包含16.14.2、18.20.4、20.11.1且无报错。

四、按需切换Node.js版本

每次执行nvm use命令，nvm-windows将立即更新当前终端会话的PATH，将目标版本的可执行文件软链接至D:\nodejs目录，并覆盖全局npm路径，该切换仅作用于当前终端窗口，不影响其他已开启的命令行实例。

1、在项目根目录下运行nvm use 18.20.4，激活该版本。

2、立即验证：node -v应返回18.20.4，npm -v应返回对应npm版本（如9.9.2）。

3、若需为某项目永久绑定版本，在该项目根目录创建.nvmrc文件，内容仅一行：18.20.4；随后进入该目录执行nvm use即可自动识别并切换。

4、设置默认启动版本（新打开的终端自动加载）：nvm alias default 18.20.4。

五、故障排查与关键修复方法

当nvm use后node -v未更新、命令不可用或提示“nvm: command not found”，通常由环境变量未刷新、权限不足或路径冲突导致，需分场景针对性修复。

1、终端未识别nvm命令：关闭所有CMD/PowerShell窗口，重新以管理员身份启动，再次运行nvm --version；若仍失败，手动将nvm安装路径（如D:\nvm）和symlinks路径（如D:\nvm\symlinks）加入系统PATH环境变量。

2、“node is not recognized”错误：检查D:\nodejs目录是否存在且非空；若为空，说明软链接未生成，运行nvm root和nvm symlink强制重建链接。

3、切换后npm仍调用旧版本：运行which npm（PowerShell中为Get-Command npm），确认输出路径为D:\nodejs\npm.cmd；若指向其他位置，清空%APPDATA%\npm目录并重试nvm use。

4、安装卡在“Downloading node.js binary”：确认settings.txt中镜像地址正确无拼写错误；临时关闭杀毒软件；或改用离线安装——从https://npmmirror.com/mirrors/node/手动下载对应版本zip包（如node-v18.20.4-win-x64.zip），解压至nvm安装目录下的v18.20.4文件夹，再执行nvm use 18.20.4。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~