第一章：搭建稳固基石——精通 Node.js 版本管理 (NVM)

在本章中，我们将首先解决所有 Node.js 开发者都会遇到的第一个，也是最棘手的问题——环境管理。我们将按照以下步骤，一劳永逸地解决它：

1. 首先，我们将进行 彻底的环境清理，为 NVM 的安装扫清障碍。
2. 接着，我们将 图文并茂地安装和配置 nvm-windows，并为其配置国内高速下载源。
3. 最后，我们将通过 核心命令实践，熟练掌握多版本 Node.js 的安装、查看与切换，并了解团队协作中的最佳实践。

1.1. 准备工作：彻底卸载已有的 Node.js

在安装 NVM 之前，最重要的一步是确保您的系统中没有其他方式安装的 Node.js 版本，否则会引起严重的冲突。

第一步：通过控制面板卸载

1. 打开 Windows 的“控制面板”。
2. 进入“程序和功能”。
3. 在右上角的搜索框中输入 node。
4. 找到 Node.js 程序，右键点击，选择“卸载”。

第二步：检查并删除残留文件

卸载程序运行完毕后，请检查以下目录，如果仍然存在，请手动删除它们：

• C:\Program Files\nodejs
• C:\Program Files (x86)\nodejs
• C:\Users\{你的用户名}\AppData\Roaming\npm
• C:\Users\{你的用户名}\AppData\Roaming\npm-cache

第三步：清理环境变量

1. 右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
2. 在“系统变量”和“用户变量”的 Path 中，检查是否存在任何与 nodejs 相关的条目，如果存在，请选中并删除。

1.2. 详解：安装 nvm-windows

第一步：下载 nvm-windows 安装包

nvm-windows 是一个社区维护的开源项目，我们需要从它的官方 GitHub 仓库下载安装程序。

请选择最新的 nvm-setup.zip 文件进行下载。

第二步：运行安装程序

解压下载的 nvm-setup.zip 文件，双击 nvm-setup.exe 启动安装向导。

第三步：选择 NVM 安装路径

安装程序会要求您选择 NVM 的安装路径。

第四步：选择 Node.js 符号链接路径

接下来，程序会要求您选择 Node.js 的符号链接路径。这个路径将作为系统当前激活的 Node.js 的“快捷方式”。同样，确保路径不含中文和空格，推荐使用默认值。

点击“Next”并完成安装。安装程序会自动为您配置好所需的环境变量。

第五步：验证安装

安装完成后，务必重新打开一个新的终端窗口（如 PowerShell 或 CMD），让新的环境变量生效。输入以下命令：

1

nvm version

看到版本号即表示 nvm-windows 安装成功！

1.3. 国内用户福利：配置高速下载镜像

默认情况下，NVM 会从国外的 nodejs.org 下载 Node.js，速度可能较慢。我们可以通过修改配置文件，将其指向速度更快的国内镜像。

第一步：找到 settings.txt 文件

在终端输入 nvm root 命令，可以查看到 NVM 的安装路径。

1

nvm root

1

Current Root: C:\Users\YourUser\AppData\Roaming\nvm

根据显示的路径，找到并打开 settings.txt 文件。

第二步：修改配置文件

在 settings.txt 文件末尾添加以下两行，使用最新的淘宝 NPM 镜像源：

1
2

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

保存文件后，NVM 下载 Node.js 的速度将得到极大提升。

1.4. 核心命令实践：安装与切换 Node.js

1. 查看可安装的版本

1

nvm list available

该命令会列出所有可供下载的 Node.js 版本。

2. 安装指定版本
我们来安装一个长期支持版（LTS）和一个较新的版本，例如：

1
2

nvm install 20.17.0 # 一个稳定的 LTS 版本
nvm install 22.5.1  # 一个较新的版本

3. 查看已安装版本

1

nvm ls

1
2

#     22.5.1
#   * 20.17.0 (Currently using 64-bit)

星号 * 表示当前终端会话正在使用的版本。

4. 切换使用版本

1
2

nvm use 22.5.1
# Now using node v22.5.1 (64-bit)

验证一下版本是否切换成功：

1
2
3

node -v && npm -v
# v22.5.1
# v10.8.1

版本已成功激活！

1.5. 团队协作的“默契”：.nvmrc 文件的规范化应用

为了保证团队成员使用统一的 Node.js 版本，我们可以在项目根目录下创建一个 .nvmrc 文件，声明项目所需的版本。

文件路径: my-new-project/.nvmrc

1

22.5.1

当团队成员进入该项目目录后，只需在终端执行 nvm use，即可自动切换到 .nvmrc 文件所指定的版本，极大提升了协作效率。

1.6. 本章核心速查总结

1.7. 高频面试题与陷阱