Win11下使用nvm管理Node版本教程

如果你正在Windows 11上为不同项目苦恼于Node.js版本冲突——比如一个项目依赖旧版Node 16而另一个必须用Node 20，却只能手动反复卸载重装？这篇教程手把手教你用nvm-windows彻底解决：从彻底清理残留Node、高速安装nvm（含淘宝镜像加速）、一键安装多个LTS版本，到灵活切换、设置默认环境，甚至通过.nvmrc实现项目级自动匹配——从此告别版本混乱，让每个项目都运行在最适配的Node环境中。

如果您在Windows 11系统中需要为不同项目匹配适配的Node.js版本，但当前仅能运行单一Node环境，则很可能是由于未启用版本隔离机制。以下是使用nvm-windows实现多版本Node.js管理的具体操作步骤：

一、彻底卸载现有Node.js与npm残留

该步骤旨在清除所有可能与nvm冲突的旧版Node安装痕迹，避免后续出现“nvm use无效”或“node命令仍指向旧路径”等典型错误。

1、打开Windows设置 → 应用 → 应用和功能，搜索“node”和“npm”，逐一卸载所有相关条目。

2、按Win+R输入cmd，执行以下命令定位残留路径：
where node
where npm

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

4、删除隐藏配置文件：
C:\Users\[用户名]\.npmrc
C:\Users\[用户名]\.npm

5、右键“此电脑”→属性→高级系统设置→环境变量，在用户变量和系统变量的Path中，删除所有含nodejs或npm的条目；同时检查NODE_PATH变量并清空。

二、下载并安装nvm-windows

Windows平台必须使用专为NT内核适配的nvm-windows，不可混用Linux/macOS版nvm，否则将无法识别命令或触发权限异常。

1、访问GitHub官方发布页：https://github.com/coreybutler/nvm-windows/releases

2、下载最新稳定版的nvm-setup.exe（例如v1.1.10），切勿下载zip源码包。

3、双击运行安装程序，注意勾选：
“Add to PATH”（添加至系统PATH）
“Use Taobao Mirror”（国内用户必选，加速安装）

4、安装路径建议设为全英文无空格目录，如：C:\nvm 或 D:\nvm，禁止使用C:\Program Files。

三、验证nvm安装并初始化环境

该步骤确保nvm已正确注入系统命令链，并可识别基础操作指令。

1、关闭所有已打开的终端窗口，以管理员身份重新启动PowerShell或CMD。

2、执行命令验证安装：
nvm -v

3、若返回类似1.1.10的版本号，说明安装成功；若提示“不是内部命令”，请检查环境变量中是否包含nvm安装路径。

4、执行命令查看当前状态：
nvm list
应显示No installations recognized，表明尚未安装任何Node版本。

四、安装多个Node.js版本

每个Node版本会独立安装对应npm，并生成隔离的全局模块存储空间，避免跨版本依赖污染。

1、列出所有可安装的LTS及稳定版本：
nvm list available

2、选择并安装常用LTS版本（示例）：
nvm install 16.20.2
nvm install 18.20.3
nvm install 20.18.3

3、安装过程中若需迁移当前全局包（如cnpm、http-server），可在命令末尾添加参数：
nvm install 20.18.3 --reinstall-packages-from=18.20.3

4、安装完成后再次执行：
nvm list
应显示已安装的全部版本，当前版本标记为->符号。

五、在项目中切换Node版本

切换操作直接影响node与npm命令的实际指向，是实现多项目兼容的核心环节。

1、查看当前生效版本：
nvm current

2、切换至指定版本（例如Node 16）：
nvm use 16.20.2

3、验证切换结果：
node -v
npm -v

4、如需设为默认启动版本（新终端自动加载）：
nvm alias default 16.20.2

5、若某项目需固定绑定特定Node版本，可在项目根目录创建.nvmrc文件，内容仅写一行版本号，如：
18.20.3，之后进入该目录执行nvm use即可自动识别。

今天关于《Win11下使用nvm管理Node版本教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！