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

如果电脑上已安装过 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 版本之间自由切换。如果后续遇到异常问题,多半是旧版本未卸载干净或路径中包含中文/空格,请仔细检查并修正。
