Windows下使用NVM管理多版本Node.js超详细教程

发表于 更新于 分类于 阅读次数：
Windows下使用NVM管理多版本Node.js超详细教程

前言

在前端开发中，我们可能会遇到需要在不同项目中使用不同版本的 Node.js 和 npm 的情况。例如，一个旧项目需要 Node.js 14.x，而一个新项目则要求必须使用 Node.js 18.x 以上。手动管理多个版本的 Node.js 不仅繁琐，还容易造成环境混乱。

NVM (Node Version Manager) 就是来解决这个问题的强大工具。通过 NVM，我们可以轻松地在电脑上安装、切换和删除任意多个 Node.js 版本。

本教程将详细讲解如何在 Windows 系统上使用 nvm-windows 来管理你的 Node.js 环境。

1. 什么是 nvm-windows？

nvm-windows 是一个专门为 Windows 系统设计的 Node.js 版本管理器。它深受 macOS 和 Linux 平台上流行的 nvm (Node Version Manager) 的启发，提供了一套相似的命令，让 Windows 用户也能享受到多版本 Node.js 带来的便利。

2. 前置准备：卸载已安装的 Node.js

在安装 nvm-windows 之前，强烈建议你先卸载掉电脑上通过官网安装包或其它方式安装的 Node.js。这可以避免日后可能出现的版本冲突和环境变量混乱问题。

卸载步骤：

  1. 打开 控制面板 -> 程序和功能 (或 设置 -> 应用 -> 应用和功能)。
  2. 在程序列表中找到 Node.js。
  3. 选中它，然后点击 卸载。
  4. 检查系统环境变量 PATH 中是否包含 Node.js 的安装路径 (例如 C:\Program Files\nodejs\)，如果存在，请将其删除。

完成以上步骤后，重启你的终端 (如 CMD, PowerShell, Git Bash) 以确保所有更改生效。

3. 安装 nvm-windows

nvm-windows 的安装过程非常简单，官方提供了一个安装程序，它会自动帮你完成所有配置。

安装步骤：

  1. 下载安装程序
    访问 nvm-windows 的官方 GitHub 发布页面：
    https://github.com/coreybutler/nvm-windows/releases

    在该页面，找到最新稳定版本的 “nvm-setup.exe” 文件并下载。

  2. 运行安装程序
    找到你下载的 nvm-setup.exe 文件，双击运行。

  3. 确认安装路径
    安装程序会显示一个窗口，让你选择 nvm 的安装路径。建议使用默认路径 C:\nvm，这符合大多数人的使用习惯，也能避免后续可能出现的权限问题。
    点击 “Next”。

  4. 确认 Node.js 存储路径
    接下来，安装程序会让你选择 Node.js 的版本存放路径（即不同版本的 Node.js 文件将下载并解压到这个目录）。同样，建议使用默认路径 C:\nodejs。
    点击 “Next”。

  5. 完成安装
    安装程序会自动配置系统环境变量（NVM_HOME 和 NVM_SYMLINK），并创建一个指向最新活动版本的符号链接 C:\nodejs。这是实现版本切换的关键。
    点击 “Install” 开始安装。安装完成后，会提示你 “Installation complete. A restart may be required to finalize changes.” (安装完成。可能需要重启电脑以使更改生效)。现在可以先不重启，我们先在终端里测试一下。

4. 基本使用命令

安装完成后，打开一个新的管理员权限的命令提示符 或 PowerShell 终端。以管理员身份运行可以避免一些后续安装 Node.js 版本时的权限问题。

以下是 nvm-windows 最常用的几个命令：

4.1 查看所有可用的 Node.js 版本

nvm list available (或 nvm ls remote) 会列出所有可以安装的远程 Node.js 版本。

1
2
3
4
5
6
7
8
9
10
11
12
13
# 命令
nvm list available

# 示例输出 (部分)
...
 v18.18.0
 v18.17.1
 ...
 v16.20.2
 ...
 v14.21.3
 ...
LTS: Long Term Support (长期支持) 版本，推荐在生产环境中使用。

4.2 安装指定版本的 Node.js

使用 nvm install <version> 命令来安装你需要的版本，例如安装最新的长期支持版。

1
2
3
4
5
# 安装最新的 LTS (长期支持) 版本
nvm install --lts

# 安装指定版本，例如安装 18.18.0
nvm install 18.18.0

在安装过程中，nvm 会自动下载对应的 Node.js 安装包，并将其解压到 C:\nodejs 目录下。

4.3 切换 Node.js 版本

安装完成后，使用 nvm use <version> 来切换你要使用的 Node.js 版本。

1
2
3
4
5
6
7
8
9
10
11
12
# 切换到刚刚安装的 18.18.0 版本
nvm use 18.18.0

# 再次查看当前使用的版本
nvm list

# 示例输出
...
  * 18.18.0 (Currently using 64-bit executable)
    16.20.2
...
# 带星号 * 的即为当前正在使用的版本

此时，打开一个新的终端（不一定要管理员权限），输入 node -v 和 npm -v，你会发现版本已经改变了。

4.4 查看已安装的版本

nvm list 会显示所有通过 nvm 安装的 Node.js 版本。

1
2
3
4
5
nvm list

# 输出示例
  * 18.18.0 (Currently using 64-bit executable)
    16.20.2

4.5 卸载指定版本

如果某个版本不再需要，可以使用 nvm uninstall <version> 将其卸载。

1
2
# 卸载 16.20.2 版本
nvm uninstall 16.20.2

5. 常用命令速查表

命令 描述
nvm list available 列出所有可以安装的 Node.js 版本
nvm install <version> 安装指定的 Node.js 版本
nvm install --lts 安装最新的 LTS 版本
nvm use <version> 切换到指定的 Node.js 版本
nvm list 列出所有已安装的 Node.js 版本
nvm uninstall <version> 卸载指定的 Node.js 版本
nvm current 显示当前正在使用的 Node.js 版本

6. 结语

通过以上步骤，你已经在 Windows 系统上成功搭建了基于 nvm-windows 的 Node.js 多版本环境。这个工具将极大地提高你开发不同项目时的灵活性，告别版本冲突的烦恼。

现在，你可以放心地去尝试不同版本，或者在不同项目之间自由切换了。祝你编码愉快！