Windows 上同时安装多个 node 版本

〇、前言

为什么需要在同一台机器上安装多个版本的 node.js？ 主要是为了解决，多项目并行开发时的版本冲突与环境隔离问题。

在 Windows 环境下，强烈建议使用 nvm-windows（Node Version Manager for Windows）来管理多版本。它可以在同一台机器上自由安装、秒级切换任意数量的 Node.js 版本，彻底根治环境混乱和依赖冲突的问题。

虽然在同一台机器安装多版本很方便，但 nvm 的设计初衷是面向单用户开发环境的。如果 Windows 服务器是共享开发环境或自动化构建服务器（CI/CD），多个用户或构建代理同时使用 nvm 切换版本时，可能会因为符号链接（Symlink）指向冲突而导致异常行为。对于这类生产级构建服务器，建议采用 Docker 容器等方案来隔离环境。

本文主要是在 Windows 上进行实践，供参考。

一、实践步骤

1.1 卸载已安装的 node，然后安装 nvm-windows

nvm 版本选择问题：

nvm 版本	适用场景	原因与建议
1.1.12	需要安装 Node.js 18 及以下版本	这是 1.1 系列的最终版，非常稳定。强烈建议使用此版本，因为它没有 1.2 系列存在的 npm 安装 bug
1.2.2	仅使用 Node.js 18 以上版本（如：20, 22, 24）	这是 1.2 系列的最新版。若只需使用新版 Node.js 时，可以使用此版本，因为它通常不受 npm 安装 bug 的影响

本文就以安装 1.1.12 版本为例。

强烈建议在安装 nvm 之前，先彻底卸载掉之前已安装的 Node.js 版本。这并非简单的建议，而是 nvm-windows 能够正常工作的前提条件。如果不进行清理，极有可能导致新安装的 nvm 无法管理 Node.js 版本，或者新旧环境发生冲突，使得 node 和 npm 命令失效。

下载指定的版本 ，下载地址（NVM 中文网 ）：https://www.nvmnode.com/zh/guide/download.html。

双击运行安装程序（nvm-setup.exe），一路"下一步"即可。

安装完成后，重新打开 CMD 或 PowerShell 终端，输入 nvm version，如果显示版本号，说明安装成功。

1.2 安装多个 node 版本

**安装之前，建议将默认的镜像地址换成国内的，速度将会上一个台阶。**Node.js 默认镜像：https://nodejs.org/dist/；npm 默认镜像：https://github.com/npm/npm/archive/12。由于这些官方源服务器位于国外，在国内网络环境下直接下载往往速度较慢，甚至容易出现超时中断的情况。

可以通过以下两条命令，来更换成淘宝的镜像地址，这个还是比较常用的。

复制代码

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

更换完成后就可以安装目标 node.js 版本了。

先安装 node.js 14.18.0 版本。

复制代码

# 查看可以下载安装的版本
C:\Users\Administrator>nvm list available
# 安装版本 node.js 14.18.0
C:\Users\Administrator>nvm install 14.18.0
Downloading node.js version 14.18.0 (64-bit)...
Complete
Creating D:\SoftDocument\nvm\temp

Downloading npm version 6.14.15... Complete
Installing npm v6.14.15...

Installation complete. If you want to use this version, type

nvm use 14.18.0
# 使用 node.js 14.18.0
C:\Users\Administrator>nvm use 14.18.0
Now using node v14.18.0 (64-bit)
# 查看已安装的 node.js 版本
C:\Users\Administrator>nvm ls

  * 14.18.0 (Currently using 64-bit executable)
# 查看当前 node.js 版本
C:\Users\Administrator>node -v
v14.18.0
# 查看当前 npm 版本
C:\Users\Administrator>npm -v
6.14.15

再安装 node.js 22.23.2 版本。

复制代码

# 安装
C:\Users\Administrator>nvm install 22.23.2
Downloading node.js version 22.23.2 (64-bit)...
Extracting node and npm...
Complete
npm v10.9.8 installed successfully.


Installation complete. If you want to use this version, type

nvm use 22.23.2
# 使用
C:\Users\Administrator>nvm use 22.23.2
Now using node v22.23.2 (64-bit)
# 查看状态
C:\Users\Administrator>nvm ls

  * 22.23.2 (Currently using 64-bit executable)
    14.18.0

为什么不选择现在最新的版本 v24.18.1？

原因是：可能存在不兼容。nvm-windows 1.1.12 是旧版的，对于最新版的 node.js 可能存在版本号无法识别的问题，具体可以自行尝试。

二、遇到的问题

2.1 Node.js v24.18.0 is not yet released or is not available

复制代码

C:\Users\Administrator>nvm install 24.18.0
Node.js v24.18.0 is not yet released or is not available.

已经成功安装了稳定的 nvm-windows 1.1.12 版本，并且也确认了淘宝镜像源上确实存在 v24.18.0 这个版本，但安装仍然失败。

问题根源：nvm-windows 1.1.12 的版本识别缺陷。

nvm-windows 1.1.12 是一个为了解决旧版 Node.js 安装问题而发布的稳定版本，但它发布时，Node.js 24 系列可能还未发布或处于早期阶段。因此，其内置的版本列表解析逻辑可能无法识别 v24.18.0 这样较新的版本号格式，导致它错误地判断该版本"不存在"或"未发布"。

最终建议就是安装版本 Node.js 22 LTS（长期支持版的最新的一个版本），即：nvm install 22.23.2。

复制代码

# 安装版本 22.23.2
C:\Users\Administrator>nvm install 22.23.2
Downloading node.js version 22.23.2 (64-bit)...
Extracting node and npm...
Complete
npm v10.9.8 installed successfully.


Installation complete. If you want to use this version, type

nvm use 22.23.2
# 查看全部已安装的 node 版本
C:\Users\Administrator>nvm ls

    22.23.2
    14.18.0
# 使用 22.23.2
C:\Users\Administrator>nvm use 22.23.2
Now using node v22.23.2 (64-bit)
# 查看使用结果
C:\Users\Administrator>nvm ls

  * 22.23.2 (Currently using 64-bit executable)
    14.18.0

2.2 如果下载比较慢，需要更换默认的镜像拉取地址

在 nvm 中，有几个国内大厂和知名高校维护的镜像源非常稳定，基本都可以保证顺畅使用。以下是目前最常用且可靠的几个选项：

1）淘宝/阿里 npmmirror（最常用）

这是目前国内前端开发者使用最广泛的镜像源，更新及时，稳定性高。

Node.js 镜像：https://npmmirror.com/mirrors/node/

npm 镜像：https://npmmirror.com/mirrors/npm/

2）清华大学开源软件镜像站（TUNA）

由清华大学维护，教育网及全国访问速度都非常快。

Node.js 镜像：https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/

3）中国科学技术大学镜像站（USTC）

由中科大维护，老牌镜像站，极其稳定。

Node.js 镜像：https://mirrors.ustc.edu.cn/node/

4）腾讯云镜像

Node.js 镜像：https://mirrors.cloud.tencent.com/nodejs-release/

npm 镜像：https://mirrors.cloud.tencent.com/npm/

5）华为云镜像

Node.js 镜像：https://mirrors.huaweicloud.com/nodejs/

npm 镜像：https://mirrors.huaweicloud.com/npm/

通过命令更换：

复制代码

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

或者在配置文件中更换：

在 nvm 的安装目录（默认路径：C:\Users\<用户名>\AppData\Roaming\nvm）下找到 settings.txt 文件，在文件内容末尾回车，加上如下镜像配置。

复制代码

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