Windows系统nvm安装与使用指南：解决Node.js多版本管理难题

1. 先搞清楚 nvm 到底解决了什么问题，以及它和直接装 Node.js 的区别

如果你在 Windows、macOS 或 Linux 上做前端或 Node.js 后端开发，迟早会遇到版本问题。比如，你手头一个老项目需要 Node.js 14，但另一个新项目必须用 Node.js 18 或 20。直接安装多个 Node.js 版本，管理起来会非常混乱，环境变量冲突、全局包路径错乱是家常便饭。

nvm（Node Version Manager）就是专门解决这个痛点的工具。它不是一个独立的运行时，而是一个版本管理命令行工具。它的核心价值就两点：一键安装/切换多个 Node.js 版本，以及为每个版本隔离全局 npm 包环境。这意味着你可以在同一台机器上，为项目 A 使用 Node.js 16，为项目 B 瞬间切换到 Node.js 20，两个版本的全局 npm 包互不干扰。

很多人第一次接触时，会把它和直接去 Node.js 官网下载安装包搞混。直接安装是“覆盖式”的，你只能有一个“当前生效”的 Node.js。而 nvm 是“仓库式”的，它帮你维护一个版本列表，你只是从中指定一个来“激活”使用。这个根本区别，决定了 nvm 是团队协作、多项目并行开发的标配工具。

所以，这篇文章适合所有需要接触不同 Node.js 版本的开发者，无论你是前端、后端还是全栈。最关键的不是学会安装命令，而是理解它的工作逻辑，以及如何避开那些让新手头疼的“坑”，比如脚本执行权限、环境变量失效、安装缓慢等问题。

2. 在 Windows 上安装 nvm：选对安装包和注意安装路径

虽然 nvm 最初是为 Unix 系统（macOS/Linux）设计的，但在 Windows 上也有官方维护的版本，就是nvm-windows。这是你唯一应该去下载的 Windows 版 nvm。不要去 GitHub 找其他同名的非官方项目。

2.1 安装前的关键准备：卸载现有 Node.js

这是最重要的一步，但很多人会忽略。如果你之前已经通过安装包（.msi）方式安装了 Node.js，必须先彻底卸载它。否则，nvm 无法接管 Node.js 的安装路径和环境变量，会导致命令冲突，出现node命令指向不明的问题。

卸载步骤：

1. 进入 Windows 的“应用和功能”设置。
2. 找到Node.js，点击卸载。
3. 同时，检查并删除可能残留的 Node.js 安装目录（通常是C:\Program Files\nodejs\）。
4. 最好也检查一下用户环境变量PATH，删除任何与 Node.js 或 npm 相关的路径。

完成这步后，你的机器上应该没有node或npm命令可用了。这是正确的起点。

2.2 下载与安装 nvm-windows

1. 访问发布页：打开浏览器，访问nvm-windows的 GitHub 发布页面。搜索 “nvm-windows releases” 就能找到。
2. 选择安装包：下载最新版本的nvm-setup.exe。我建议用setup版本，因为它能帮你自动配置系统环境变量，比手动配置 zip 包省心得多。
3. 安装过程注意点：
   • 安装路径：安装程序会询问 nvm 的安装路径。默认是C:\Users\你的用户名\AppData\Roaming\nvm。我强烈建议就用这个默认路径。不要改到C:\Program Files或其它需要管理员权限的目录，否则后续操作可能频繁触发权限提示。
   • Node.js 符号链接路径：接下来会问你 “Node.js Symlink” 的路径。默认是C:\Program Files\nodejs。这个路径非常重要。nvm 会在这里创建一个符号链接（可以理解为一个快捷方式），指向你当前激活的 Node.js 版本。系统环境变量PATH里指向的就是这个目录。所以，保持默认即可，除非这个目录有特殊权限问题。

安装完成后，一定要重新打开一个全新的命令行窗口（CMD 或 PowerShell）。这样新的环境变量才会生效。

2.3 验证安装与解决首次运行问题

打开新的命令行，输入：

nvm version

如果正确显示 nvm 的版本号（如1.1.12），说明安装成功。

但很多人在第一次使用nvm list或nvm install时，可能会遇到一个经典的 PowerShell 权限错误，这正是热搜词里提到的：

nvm : 无法加载文件 D:\nvm\nodejs\npm.ps1，因为在此系统上禁止运行脚本。

这个错误和 nvm 本身关系不大，而是 Windows 系统默认的 PowerShell 执行策略（Execution Policy）限制导致的。它禁止运行未签名的本地脚本。

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

方法一（推荐，仅当前窗口生效）：以管理员身份打开 PowerShell，执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后在弹出的确认提示中输入Y。这仅为当前用户修改策略，相对安全。之后在同一个PowerShell 窗口里，nvm 命令就可以正常工作了。

方法二（更便捷）：如果你不想改策略，或者改完依然有问题，最直接的办法是改用命令提示符（CMD）来运行 nvm 命令。nvm-windows 在 CMD 下工作是完全正常的，不会触发 PowerShell 的脚本策略。对于日常的版本安装、切换，用 CMD 足够了。

我个人的习惯是：在 CMD 里管理版本（nvm install,nvm use），在 VS Code 的终端（可以设置为 CMD）或其它 IDE 终端里进行项目开发。这样可以完美避开 PowerShell 的权限困扰。

3. 核心使用流程：安装、切换、查看与日常管理

nvm 的命令非常简洁，核心就是几个动词。下面我们按照实际使用的顺序来走一遍。

3.1 查看可安装版本与安装 Node.js

安装好 nvm 后，第一件事是安装一个 Node.js 版本。

1. 查看远程可用版本：

   nvm list available

   这个命令会列出所有官方可安装的 Node.js 版本号。你会看到很多版本，包括最新的 Current 版本、长期支持（LTS）版本，以及较旧的版本。

2. 安装指定版本： 假设你需要安装最新的 LTS 版本，它的代号可能是 “Hydrogen”。你可以直接安装：

   nvm install lts

   或者安装一个精确版本：

   nvm install 18.19.0

   安装过程注意：nvm 会从 Node.js 官方源下载，速度取决于你的网络。如果遇到下载缓慢或超时，是因为默认源在国外。我们可以配置淘宝镜像来加速（这步很重要）：

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

   设置镜像后，再执行nvm install命令，速度会有显著提升。

3. 验证安装：安装完成后，nvm 默认不会自动“使用”这个新版本。你需要先“切换”到它（见下文）。但你可以通过以下命令查看已安装的版本列表：

   nvm list

   或

   nvm ls

   你会看到所有已安装的版本，前面带*或->的表示当前正在使用的版本。

3.2 切换与使用版本

这是 nvm 最常用的功能。

1. 切换版本：

   nvm use 18.19.0

   或者，如果你安装时用了别名lts：

   nvm use lts

   成功后会提示Now using node v18.19.0 (64-bit)。

2. 验证切换结果：切换后，立即检查：

   node -v npm -v

   这两个命令输出的版本号应该与你刚刚切换的版本一致。同时，检查where node命令，它显示的 node.exe 路径应该在 nvm 的安装目录下（如C:\Users\xxx\AppData\Roaming\nvm\v18.19.0\node.exe），而不是其他地方。

3. 设置默认版本：每次新开命令行窗口，nvm 可能会重置。如果你希望某个版本作为默认启动版本，可以：

   nvm alias default 18.19.0

   这样，以后新开的终端都会自动使用这个版本。

3.3 卸载版本与其它实用命令

• 卸载一个版本：

  nvm uninstall 14.21.3

  在卸载前，请确保你没有正在使用这个版本（nvm use到其他版本）。

• 查看当前使用版本的安装路径：

  nvm which current

  这在配置 IDE 或需要绝对路径时有用。

• 快速运行特定版本的 Node.js（不切换全局环境）：

  nvm run 16.20.2 app.js

  这个命令会用 Node.js 16.20.2 来运行app.js文件，但执行完后，你的全局版本还是原来的，不会变。适合快速测试。

4. 高级场景、常见问题与排查思路

掌握了基本命令只是开始，把 nvm 用稳，还需要处理一些边界情况和问题。

4.1 全局 npm 包与版本隔离

这是 nvm 的另一个核心优势：版本隔离。当你用nvm use切换到 Node.js 18 后，用npm install -g yarn安装的全局 yarn，只存在于 Node.js 18 的环境下。当你切换到 Node.js 16 时，那个全局 yarn 是不可用的，你需要重新安装。

好处：项目环境纯净，不会因为全局包版本冲突导致奇怪错误。注意：这意味着一些你习惯的全局工具（如nodemon,pm2,typescript等），需要在每个常用的 Node.js 版本下分别安装一次。

4.2 配合项目自动化切换（.nvmrc 文件）

在项目根目录创建一个名为.nvmrc的文件，里面只写版本号，例如：

20.11.0

然后，在该目录下执行：

nvm use

nvm 会自动读取.nvmrc文件中的版本并切换过去。这对于团队协作非常有用，确保所有人使用相同的 Node.js 版本进行开发。

4.3 WSL（Windows Subsystem for Linux）中安装 nvm

热搜词里有 “wsl安装nvm安装node”。在 WSL 的 Linux 发行版（如 Ubuntu）中安装 nvm，过程和原生 Linux 一致，通常更简单。

1. 通过 curl 或 wget 下载安装脚本：

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

   或者

   wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

   （注意版本号v0.39.7请替换为当时最新的稳定版）。

2. 安装脚本会自动克隆仓库到~/.nvm，并尝试在~/.bashrc,~/.zshrc等文件中添加源。安装完成后，你必须关闭当前终端，重新打开，或者执行source ~/.bashrc，nvm 命令才会生效。

3. 之后的使用命令和 Windows 版完全一样（nvm install,nvm use等）。WSL 中的 nvm 和 Windows 宿主系统中的nvm-windows是完全独立的两个东西，它们管理的 Node.js 版本也互不干扰。

4.4 典型问题排查链路

当 nvm 命令不按预期工作时，按这个顺序排查：

1. 命令未找到：输入nvm提示不是命令。

   • Windows：检查是否以管理员身份运行了安装程序？是否在安装后打开了新的 CMD/PowerShell 窗口？环境变量NVM_HOME和NVM_SYMLINK是否已添加？可以回看安装路径章节。
   • macOS/Linux/WSL：是否执行了source ~/.bashrc或重启了终端？安装脚本是否成功修改了 shell 配置文件？可以用cat ~/.bashrc | grep nvm查看。

2. 切换版本后node -v没变：

   • 首先确认切换命令是否成功（有成功提示）。
   • 执行where node（Windows）或which node（macOS/Linux）。如果显示的路径不是 nvm 目录下的（比如还是旧的C:\Program Files\nodejs），说明系统PATH环境变量中旧 Node.js 的路径优先级更高。回到第一步，彻底卸载旧版本 Node.js。

3. nvm use需要管理员权限：

   • 这通常发生在 Windows 上，如果你把 nvm 或 Node.js 的符号链接装到了受保护目录（如C:\Program Files）。解决方案就是卸载重装，使用默认的、不需要管理员权限的用户目录路径。

4. 安装 Node.js 版本失败：

   • 网络问题最常见：配置淘宝镜像加速。
   • 权限问题：确保 nvm 安装目录有写入权限。
   • 杀毒软件/防火墙拦截：暂时禁用或添加例外。
   • 磁盘空间不足：检查目标磁盘。

5. 全局 npm 包丢失：

   • 记住，这是特性不是 bug。每个 Node.js 版本有独立的全局node_modules。切换到新版本后，常用的全局工具需要重新npm install -g一次。

4.5 与其它工具（如 nvs, fnm）的简单对比

nvm 不是唯一选择，但是最经典、社区最广的。类似工具还有nvs(Node Version Switcher, 跨平台由微软维护)、fnm(Fast Node Manager, 用 Rust 写，速度更快)。它们核心功能相似，区别在于：

• nvm：最稳定，功能最全，文档最丰富，支持.nvmrc，但 Shell 启动稍慢（因为它是 Shell 脚本）。
• fnm：启动速度极快，兼容.nvmrc，但相对年轻，某些边缘场景可能不如 nvm 成熟。
• nvs：跨平台体验一致，支持自动根据.nvsrc切换。

对于绝大多数开发者，从nvm（Windows 用nvm-windows）开始是最稳妥的选择。它的所有“坑”基本都被踩过一遍，解决方案网上也最全。

最后，我建议你把 nvm 的常用命令（list,install,use,alias default）记熟，再把镜像配置好。真正开发时，90%的时间你只需要nvm use这一个命令。管理多版本 Node.js 环境从此应该是一个轻松、可预测的过程，而不是一个玄学问题。如果在团队中推广，务必统一使用.nvmrc文件，这是保证开发环境一致性的最低成本方案。