Windows 系统下通过 nvm 管理 Node.js 版本的详细指南

文
章
目
录

• 一、卸载已安装的 Node.js
• 1. 卸载 Node.js
• 2. 删除环境变量
• 3. 删除相关文件
• 二、安装 nvm
• 1. 下载 nvm 安装包
• 2. 安装 nvm
• 三、使用 nvm 安装和切换 Node.js 版本
• 1. 查看可安装的 Node.js 版本
• 2. 安装指定版本的 Node.js
• 3. 切换 Node.js 版本
• 四、扩展知识
• 1. 配置 nvm 使用淘宝镜像
• 2. 如何选择合适的 Node.js 版本

本文详细介绍了如何在Windows系统下通过nvm管理Node.js版本。首先，需要卸载已安装的Node.js并清理相关环境变量和文件。接着，通过下载并安装nvm来实现对多个Node.js版本的管理。安装完成后，用户可以通过nvm快速安装、切换不同版本的Node.js，以满足开发需求。

在开发过程中，经常会遇到因 Node.js 版本不兼容而导致的项目运行问题。例如，最近我在搭建一个 Vue 3 项目时，运行 npm run dev 时出现了 structuredClone is not defined 的错误。经过查询得知，这是因为 structuredClone 是 JavaScript 中较新的功能，如果运行环境（浏览器或 Node.js 版本）较旧，可能不支持该函数。为了避免手动升级 Node.js 的繁琐操作，我发现了 nvm 这个强大的工具，它可以方便地管理和切换多个 Node.js 版本。以下是我在 Windows 系统下通过 nvm 管理 Node.js 版本的详细步骤记录。

一、卸载已安装的 Node.js

如果系统中已经安装了 Node.js，需要先将其卸载，否则可能会导致 nvm 安装失败。

1. 卸载 Node.js

通过控制面板中的“程序和功能”选项，找到已安装的 Node.js 并进行卸载。

2. 删除环境变量

按下 Win+R 组合键打开运行对话框，输入 sysdm.cpl 命令并回车，选择“高级”选项卡，点击“环境变量”按钮，将与 Node.js 相关的环境变量全部删除。

3. 删除相关文件

检查 Node.js 安装目录，若有残留的文件夹则将其删除；同时，查看 C:\\Users\\用户名 文件夹下是否存在 .npmrc、.yarnrc 等文件，若有也一并删除。

二、安装 nvm

完成上述卸载操作后，即可开始安装 nvm。

1. 下载 nvm 安装包

访问 nvm-windows 官方 GitHub Releases 页面，下载最新版本的 nvm 安装包。



2. 安装 nvm

将下载好的安装包解压后，按照提示进行安装。安装完成后，通过 Win+R 组合键打开运行对话框，输入 cmd 命令并回车，打开命令提示符，输入 nvm version 命令来验证 nvm 是否安装成功。如果显示了 nvm 的版本号，则说明安装成功。

三、使用 nvm 安装和切换 Node.js 版本

1. 查看可安装的 Node.js 版本

在命令提示符中输入 nvm list available 命令，查看所有可安装的 Node.js 版本。

2. 安装指定版本的 Node.js

根据项目需求选择一个合适的版本进行安装，例如安装 20.10.0 版本，可在命令提示符中输入 nvm install 20.10.0 命令。

3. 切换 Node.js 版本

安装完成后，通过输入 nvm use 20.10.0 命令切换到该版本。此时，再次运行 node -v 命令，即可看到当前使用的 Node.js 版本已成功切换为 20.10.0。

四、扩展知识

1. 配置 nvm 使用淘宝镜像

由于国内网络环境的限制，下载 Node.js 时可能会出现速度较慢的情况。可以通过修改 nvm 安装路径下的 settings.txt 文件，将镜像源切换为淘宝镜像，从而提高下载速度。



2. 如何选择合适的 Node.js 版本

在使用 nvm 安装 Node.js 时，会看到 CURRENT、LTS、OLD STABLE 和 OLD UNSTABLE 四种类型的版本，它们各自的特点如下：

• CURRENT（当前版本） ：是 Node.js 的最新发布版本，包含最新的特性和改进，但可能尚未经过充分的生产环境测试，适合喜欢尝试新特性的开发者。每个 CURRENT 版本会在发布后 6 个月进入 LTS 阶段，或者被淘汰。
• LTS（长期支持版本） ：是 Node.js 的长期支持版本，稳定性高，经过充分测试，适合生产环境使用。LTS 版本会经历 Active LTS 和 Maintenance LTS 两个阶段，其中 Active LTS 持续 12 个月，定期发布更新；Maintenance LTS 持续 18 个月，仅修复重大 bug 和安全问题。
• OLD STABLE（旧稳定版本） ：是指已经结束 LTS 支持的旧版本，不再接收安全更新或 bug 修复，不建议在生产环境中使用。
• OLD UNSTABLE（旧非稳定版本） ：是指那些从未进入 LTS 阶段的旧版本，不再接收任何更新，不建议使用。

因此，在选择 Node.js 版本时，如果是用于生产环境，建议选择最新的 LTS 版本；如果是开发环境，可以尝试使用 CURRENT 版本来体验最新特性；而应尽量避免使用 OLD STABLE 和 OLD UNSTABLE 版本。