Windows 系统 Node.js 多版本管理指南：使用 NVM-Windows

本文适用于 Windows 操作系统。Linux/macOS 用户请使用 nvm-sh/nvm。

通过 nvm-windows，你可以轻松安装、切换不同版本的 Node.js，避免版本冲突，并结合国内镜像加速下载和安装过程。

第一步：安装 NVM for Windows

1. 下载安装包

前往官方仓库下载最新版安装程序：

nvm-windows GitHub Releases

推荐选择文件名为 nvm-setup.exe 的最新稳定版本（如 nvm-setup-v1.1.12.exe），双击安装即可。

注意：避免将 NVM 安装在带有空格或中文路径的目录中（如“Program Files”或“我的文档”）。

2. 配置国内镜像源（提升下载速度）

安装完成后，在 NVM 安装目录下（例如 D:\nvm）找到并编辑 settings.txt 文件，添加以下内容：

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

保存后，后续通过 nvm install 安装 Node.js 时将自动从国内镜像下载，显著提升速度。

第二步：常用 NVM 命令速查表

示例操作：

nvm install 18.17.0
nvm use 18.17.0

成功切换后，运行 node -v 应显示对应版本号。

第三步：自定义 npm 全局路径（释放 C 盘空间）

默认情况下，npm 全局包会安装在：

C:\Users\<用户名>\AppData\Roaming\npm

这可能导致 C 盘占用过高。建议将其迁移到非系统盘。

1. 设置新的全局路径和缓存路径

在命令行中执行以下命令（以 D 盘为例）：

# 设置全局包安装目录
npm config set prefix "D:\nvm\nodejs\node_global"

# 设置缓存目录（缓存体积较大）
npm config set cache "D:\nvm\nodejs\node_cache"

路径可根据实际安装位置调整，建议与 NVM 安装目录统一管理。

2. 手动创建文件夹

请确保以下两个文件夹已存在，否则可能导致后续安装失败：

• D:\nvm\nodejs\node_global
• D:\nvm\nodejs\node_cache

右键资源管理器创建即可。

第四步：更换 npm 镜像源（加速包安装）

默认 npm 源位于国外，速度慢。建议更换为国内镜像源。

推荐使用：npmmirror（淘宝镜像）

# 查看当前源
npm config get registry

# 设置为国内镜像源
npm config set registry https://registry.npmmirror.com

验证是否生效：

npm config get registry
# 输出应为：https://registry.npmmirror.com/

可选其他国内源（中科大、腾讯云等），但 npmmirror 是目前最稳定、更新最快的公共镜像之一。

第五步：配置系统环境变量（确保全局命令可用）

为了让全局安装的包（如 vue-cli、typescript、pnpm 等）能在任意终端中运行，必须将 prefix 路径加入系统 PATH。

操作步骤：

1. 按下 Win + S，搜索 “环境变量”，打开 “编辑系统环境变量”
2. 点击 “环境变量” 按钮
3. 在 “系统变量” 区域找到 Path，点击 编辑
4. 点击 新建，添加你的全局路径（如）：

   D:\nvm\nodejs\node_global

5. 点击确定保存所有设置

重启终端或 VS Code，使更改生效。

测试：安装一个全局包后尝试调用命令，如：

npm install -g pnpm
pnpm -v

第六步：验证配置是否成功

打开新的命令行窗口（CMD / PowerShell），依次执行以下命令：

node -v        # 应输出 Node.js 版本号
npm -v         # 应输出 npm 版本号
nvm list       # 显示已安装的 Node.js 版本
npm config get prefix   # 应显示自定义的全局路径
npm config get cache    # 应显示自定义缓存路径
npm config get registry # 应显示 https://registry.npmmirror.com

如果所有命令均正常输出，恭喜你！Node.js 开发环境已高效配置完成 ✅

总结：构建高效 Node.js 开发环境的关键要素

结语

通过以上配置，你已经拥有了一个：

• 灵活的多版本 Node.js 管理方案
• 快速稳定的包安装体验
• 合理的磁盘空间利用结构

再也不用担心「版本冲突」、「C盘爆满」、「npm 安装龟速」等问题！

开始你的高效前端/Node.js 开发之旅吧！

参考资料：

• nvm-windows GitHub
• npmmirror 官网
• Node.js 官方文档

建议收藏本指南，作为日常开发环境配置参考手册。