1. 项目概述：为什么在Windows上需要NVM？

如果你在Windows上做过前端或者Node.js后端开发，肯定遇到过版本管理的麻烦。今天想用Node 18跑一个老项目，明天新项目又要求Node 20，来回卸载重装Node.js，不仅费时费力，还容易把环境搞得一团糟。更头疼的是，全局安装的npm包会因为Node版本切换而失效，出现各种“模块未找到”的报错。我之前就深受其害，直到我开始用NVM（Node Version Manager）。

简单说，NVM就是一个Node.js的版本管理工具，它允许你在同一台Windows机器上安装多个版本的Node.js，并且可以随时、轻松地在它们之间切换。这不仅仅是“有多个版本”那么简单，NVM为每个版本都创建了独立的沙箱环境。当你切换到Node 18时，你用npm全局安装的包（比如yarn、pm2）只存在于Node 18的环境里；切换到Node 20后，你需要重新安装这些全局包，这样就彻底避免了版本冲突。

网上很多教程只告诉你怎么安装，但没讲清楚背后的逻辑和实际使用中会遇到的坑。比如，为什么安装后npm命令报“禁止运行脚本”的错误？怎么彻底卸载一个Node版本？nvm use命令有时为何不生效？这篇内容，我就结合自己多年的踩坑经验，把Windows下NVM从安装、配置到深度使用的完整链条给你捋清楚，让你不仅能装上，更能用得明白、用得顺畅。

2. NVM for Windows的安装与核心机制解析

首先得明确，我们说的“Windows下的NVM”通常指的是nvm-windows这个开源项目，它并不是Linux/macOS上那个原生NVM的移植，而是一个用Go语言重写的、专为Windows设计的实现。两者命令基本兼容，但底层机制和部分高级特性有差异，这点心里要有数。

2.1 安装前的关键准备：彻底清理旧Node环境

这是最重要的一步，也是绝大多数安装失败和后续诡异问题的根源。如果你之前通过.msi安装包或者安装程序装过Node.js，必须彻底清理。

为什么必须清理？因为Windows安装程序会把Node.js和npm的可执行文件路径（比如C:\Program Files\nodejs）直接写入系统的PATH环境变量。当你再安装NVM时，NVM会尝试通过修改PATH来接管Node命令。如果旧路径仍然存在，系统在查找node或npm命令时，就可能找到旧版本的，导致版本混乱，nvm use命令失效。

我的清理操作清单：

1. 控制面板卸载：进入“设置 -> 应用 -> 应用和功能”，找到所有包含“Node.js”字样的程序，全部卸载。
2. 手动删除残留目录：卸载程序通常不干净，需要手动检查并删除以下目录（如果存在）：
   • C:\Program Files\nodejs
   • C:\Program Files (x86)\nodejs
   • C:\Users\[你的用户名]\AppData\Roaming\npm(这是全局npm包安装目录)
   • C:\Users\[你的用户名]\AppData\Roaming\npm-cache
3. 清理环境变量：打开“系统属性 -> 高级 -> 环境变量”，检查用户变量和系统变量中的PATH，删除任何指向上述Node.js目录的条目。
4. 重启终端或电脑：确保所有环境变量的更改生效。最好重启一下电脑，最省心。

完成这波操作后，你的机器应该就是一个“纯净”的Windows环境，为NVM的安装铺平了道路。

2.2 安装过程详解与目录结构剖析

去nvm-windows的GitHub发布页下载最新的安装程序（.exe文件）。安装过程有几个选项需要留意：

• 安装路径：默认是C:\Users\[用户名]\AppData\Roaming\nvm。我建议保持默认，因为这个路径通常没有空格和特殊字符，兼容性最好。如果你想改到D:\nvm之类的也可以，但路径务必用英文，且不要有空格。
• Symlink（符号链接）目录：这是NVM工作的核心机制。安装程序会问你把符号链接放到哪里，默认是C:\Program Files\nodejs。这个目录非常重要。
  • 原理：NVM并不会把每个Node版本的可执行文件都加到PATH里。它只把这个符号链接目录（即C:\Program Files\nodejs）加入系统PATH。当你执行nvm use 18.19.0时，NVM会把你指定的Node版本的实际文件，映射到这个符号链接目录下。系统在PATH里找到C:\Program Files\nodejs，进而找到里面的node.exe和npm.cmd，实际上访问的是当前激活版本的真实文件。
  • 权限问题：由于默认路径在C:\Program Files下，如果你不是管理员，或者某些安全软件限制，可能会导致NVM切换版本时创建符号链接失败。如果遇到问题，可以考虑将符号链接目录设置到用户目录下，比如C:\Users\[用户名]\nodejs，但需要手动调整PATH。

安装完成后，务必以管理员身份重新打开一个CMD或PowerShell窗口。因为安装程序修改了系统PATH，且创建符号链接需要管理员权限，普通窗口可能无法立即识别nvm命令或成功执行nvm use。

打开新终端，输入nvm -v，如果显示版本号（如1.1.12），恭喜你，安装成功了。

3. NVM的核心使用命令与全局配置陷阱

安装成功只是第一步，会用才是关键。下面这些命令是你每天都会打交道的。

3.1 基础命令：安装、列表、切换与卸载

# 查看所有可安装的Node.js版本（远程列表） nvm list available # 安装指定版本的Node.js，例如安装最新的LTS版本 nvm install 18.19.0 # 也可以安装最新稳定版 nvm install latest # 查看本地已安装的所有Node.js版本 nvm list # 或 nvm ls # 切换到指定版本使用 nvm use 18.19.0 # 卸载某个已安装的版本 nvm uninstall 18.19.0

使用心得：

• nvm install会同时安装对应版本的Node.js和npm。
• nvm list输出中，当前正在使用的版本前面会有一个*号，并且指向C:\Program Files\nodejs这个符号链接。
• nvm use是临时切换，只对当前这个终端窗口生效。你新开一个CMD，默认还是会用nvm设置的“默认版本”（如果设置了的话）。

3.2 配置默认版本与镜像加速

为了让新开的终端自动使用某个版本，需要设置默认版本。

# 将已安装的 18.19.0 设置为默认版本 nvm alias default 18.19.0

设置后，每次新开终端，都会自动执行一次nvm use 18.19.0。

关于下载镜像（重要！）：Node.js和npm的官方源在国外，下载速度可能很慢甚至失败。NVM for Windows 通过修改环境变量来配置镜像。

1. 在NVM的安装目录（如C:\Users\[用户名]\AppData\Roaming\nvm）下，找到settings.txt文件。
2. 用记事本打开，添加或修改以下两行：

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

   npmmirror.com（淘宝镜像）是国内最稳定的选择。这样之后执行nvm install，下载速度会飞起。

3.3 最经典的坑：PowerShell执行策略与npm报错

这是Windows用户使用NVM后几乎百分百会遇到的“当头一棒”。当你安装好Node，兴冲冲地运行npm -v时，可能会看到如下错误：

npm : 无法加载文件 D:\nvm\nodejs\npm.ps1，因为在此系统上禁止运行脚本。有关详细信息，请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。

为什么会出现这个错误？这是因为NVM在安装Node时，会把npm的可执行文件（一个PowerShell脚本npm.ps1）链接到符号链接目录。而Windows PowerShell默认的执行策略（Execution Policy）是Restricted（禁止运行任何脚本），这是出于安全考虑。所以当你运行npm时，PowerShell阻止了这个脚本的执行。

解决方案（选一种即可）：

方案A：为当前用户更改执行策略（推荐）在以管理员身份运行的PowerShell中，执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

这条命令的意思是：为当前用户，将执行策略设置为RemoteSigned。该策略允许运行本地脚本，而来自互联网的脚本需要数字签名。npm.ps1是本地脚本，所以可以运行。这个设置只影响你的账户，比较安全。

方案B：在命令前绕过策略（临时）如果你不想修改策略，每次运行npm相关命令时可以：

powershell -ExecutionPolicy Bypass -Command "npm -v"

或者，更常见的做法是：对于Node.js开发，直接使用CMD命令提示符而不是PowerShell。CMD不依赖PowerShell的执行策略，因此不会出现此问题。很多老牌开发者习惯用CMD配nvm，就是这个原因。

注意：这个错误只发生在PowerShell中。在CMD或者VSCode的内置终端（如果默认是PowerShell也会）里你会遇到。Git Bash通常不受影响。

4. 高级场景：工程化配置与疑难杂症排查

掌握了基础，我们来看看如何把NVM用得更加“工程化”，以及如何处理那些令人头疼的异常。

4.1 为不同项目自动切换Node版本（.nvmrc）

在团队协作中，项目A用Node 16，项目B用Node 18，手动切换容易忘。最佳实践是在项目根目录创建一个.nvmrc文件。

1. 在项目根目录，创建一个名为.nvmrc的文本文件（没有文件名，只有扩展名）。
2. 在里面写上版本号，例如：18.19.0
3. 进入该项目目录后，只需执行：

   nvm use

   NVM会自动读取.nvmrc文件中的版本号并切换过去。你可以把这个命令写进项目的README.md，或者搭配direnv等工具实现进入目录自动切换。

4.2 全局包管理与版本隔离的再理解

这是NVM的核心优势，也是容易混淆的点。记住一个原则：每个Node版本都有自己独立的全局包空间。

• 你在Node 18下npm install -g yarn，这个yarn只有当你使用nvm use 18时才能被调用。
• 切换到Node 20后，yarn命令会报“不是内部或外部命令”，因为Node 20的全局包里还没有安装它。
• 如果你想在两个版本下都用yarn，就需要分别切换过去各自安装一次。

查看某个版本下的全局包：

# 先切换到目标版本 nvm use 18.19.0 # 然后查看 npm list -g --depth=0

4.3 常见疑难杂症与排查清单

问题1：nvm use成功，但node -v还是显示旧版本/不对。

• 排查：首先，关闭所有终端，重新以管理员身份打开一个。然后按顺序检查：
  1. where node命令。这个命令会列出系统PATH中所有名为node的可执行文件位置。如果第一个结果不是C:\Program Files\nodejs\node.exe，说明有其他Node残留抢占了优先级。根据where的结果，回去清理环境变量。
  2. 检查当前终端是否是PowerShell且执行策略未改，尝试在CMD中操作。
  3. 检查NVM安装目录和符号链接目录的权限，确保当前用户有写入权限。

问题2：安装NVM或切换版本时，提示“Exit code 1”或“拒绝访问”。

• 原因：几乎都是权限问题。NVM需要向C:\Program Files\nodejs创建符号链接。
• 解决：始终以管理员身份运行你的终端（CMD或PowerShell）。这是Windows下使用NVM最省心的习惯。

问题3：通过NVM安装的Node，在VSCode终端里版本不对。

• 原因：VSCode的终端可能继承了旧的PATH环境变量。
• 解决：完全关闭VSCode，再重新打开。VSCode在启动时会读取一次系统环境变量。

问题4：想彻底卸载NVM和所有Node版本。

1. 使用控制面板卸载nvm-windows程序。
2. 手动删除NVM的安装目录（如C:\Users\[用户名]\AppData\Roaming\nvm）和符号链接目录（如C:\Program Files\nodejs）。
3. 清理环境变量PATH中与这两个目录相关的条目。
4. 删除用户目录下的.npmrc等可能残留的配置。

5. 与其它开发环境工具的协作

NVM不是孤立的，它需要和你其他的工具链和平共处。

5.1 在WSL（Windows Subsystem for Linux）中使用NVM

很多开发者会在Windows上使用WSL来获得Linux开发环境。注意，WSL里的Linux是一个独立系统，不能直接使用Windows上安装的NVM for Windows。

你需要在WSL的Linux发行版（如Ubuntu）内部，按照Linux的方式安装原生的NVM。命令通常是：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

然后配置.bashrc或.zshrc。这样，你在WSL里管理的Node版本和Windows宿主系统里的完全是两套，互不干扰。这也意味着你可能需要配置两套镜像源。

5.2 让IDE（如VSCode、WebStorm）识别正确的Node版本

IDE内置的终端或代码分析功能依赖PATH来找到Node。

• VSCode：只要你是在正确配置了NVM的终端（管理员权限的CMD/PowerShell）里用code .命令打开项目，或者重启VSCode后，其内置终端通常能继承正确的PATH。你也可以在VSCode的设置中搜索Terminal > Integrated: Env，配置环境变量，但通常不需要。
• 关键点：确保IDE使用的终端类型（CMD、PowerShell、Git Bash）和你成功运行nvm use的终端类型一致。如果IDE默认用PowerShell且执行策略有问题，可以尝试在VSCode的设置里将默认终端改成CMD。

5.3 与包管理器（Yarn、pnpm）的配合

Yarn、pnpm这些包管理器，同样遵循“全局包隔离”的原则。

• 你需要在你使用的每个Node版本下，分别全局安装它们一次：npm install -g yarn pnpm。
• 它们的全局缓存和配置目录（如~/.yarnrc）通常是用户级共享的，但由不同Node版本安装的包管理器实例本身是独立的。

最后，我个人最深刻的体会是：在Windows下玩转NVM，“管理员权限”和“环境变量”是两大命门。90%的问题都源于此。养成在需要操作Node版本时，就右键“以管理员身份运行”终端的习惯，能替你省下大量排查的时间。另外，不要害怕彻底卸载和重装，有时候一个干净的开始比花几小时排查各种幽灵问题要高效得多。把NVM配好了，你在Node.js版本的世界里就真正拥有了自由。