nvm-windows安装教程 Node.js多版本管理避坑指南

在正式开始安装之前，有几个关键事项需要提前确认，否则后续步骤容易遇到问题。

如果电脑上已安装过 Node.js，强烈建议先彻底卸载干净。这一步不可跳过，否则在使用 nvm 切换版本时可能引发各种异常冲突。此外，请提前下载好 nvm-setup.exe 安装文件，后续安装流程会用到。

二、安装步骤详解

整个过程并不复杂，按照以下顺序操作即可完成。

1. 启动安装程序
右键点击 nvm-setup.exe，选择【以管理员身份运行】——这一步至关重要，普通双击可能权限不足导致安装失败。

2. 同意许可协议
点击【I Accept...】按钮，然后点击【Next】继续，无需犹豫。

3. 设置 nvm 安装路径
此处选择 nvm 程序本身的安装目录。建议放置在非系统盘（如C盘以外的盘符），例如 D:\nvm，路径中避免包含中文或空格，以防止后续出现不可预知的错误。选择完成后点击【Next】。

4. 设置 Node.js 版本存储路径
此步骤用于指定各个 Node.js 版本的存放目录。建议与上一步 nvm 安装路径位于同一磁盘，例如 D:\nodejs。点击【Next】继续。

5. 开始安装
点击【Install】按钮，等待进度条完成即可，通常只需几秒钟。

6. 完成安装
当安装界面显示“Completed”字样后，点击【Finish】按钮关闭安装窗口。

三、验证安装是否成功

安装完成后，先别急着使用，快速验证一下是否安装成功。

按下 Win + R 组合键，输入 cmd 并回车，打开命令提示符窗口。然后输入以下命令：

nvm version

如果命令行中返回类似 1.1.12 的版本号，则表示安装成功。

四、必做的基础配置（更换国内镜像源）

新安装的 nvm 默认连接国外服务器下载 Node.js，下载速度极慢，严重影响体验。强烈建议更换为国内镜像源：

在命令提示符窗口中依次执行以下两行命令：

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

完成配置后，后续安装 Node.js 版本时将获得极快的下载速度。

五、如何使用 nvm？（常用命令汇总）

配置好镜像源后，就可以开始使用 nvm 管理 Node.js 版本了。以下常用命令足以满足日常需求：

• 查看可安装的 Node 版本：
  nvm list available
  此命令会列出所有可用的 Node.js 版本号，根据需求选择安装即可。
• 安装指定版本：
  nvm install 18.20.0
  将版本号替换为你需要的版本即可。
• 切换使用版本：
  nvm use 18.20.0
  注意：切换版本后建议重启终端或重新打开命令提示符，以确保环境变量正确刷新。
• 查看已安装的版本：
  nvm list
  当前正在使用的版本会在列表前显示一个 * 标记。

掌握以上命令，即可在多个 Node.js 版本之间自由切换。如果后续遇到异常问题，多半是旧版本未卸载干净或路径中包含中文/空格，请仔细检查并修正。