Windows下nvm安装与完整使用教程

做前端开发，经常会遇到不同项目要求Node.js版本不一样的问题，版本来回切换很麻烦，nvm就是用来管理多版本Node.js的工具，轻松实现一键切换Node版本。

一、为什么要安装nvm？

开发过程中，不同前端项目对 Node.js 的版本要求各不相同。 如果本地只装一个Node版本，切换项目时就需要反复卸载重装，非常麻烦。 nvm 可以在电脑上同时保存多个 Node.js 版本，需要哪个版本就一键切换，完美解决版本兼容问题。

💡注意：Windows系统使用的是 nvm‑windows，和mac/linux的nvm不是同一个工具。

二、下载nvm‑windows安装包

📥下载地址

GitHub官方发布页：

https://github.com/nvm‑windows/nvm/releases

📌版本选择指南

✅如何确认自己电脑系统架构： 打开 设置 → 系统 → 关于，查看系统类型字段，显示64位操作系统，就选择amd64版本。

三、安装nvm

1. 找到下载好的 nvm‑2.0.0‑amd64‑setup.exe，右键→以管理员身份运行。

⚠️两个重要目录区分，千万别搞混：

1. nvm自身安装目录
   程序强制固定路径：C:\Users\你的用户名\AppData\Local\Author Software\nvm，安装过程无法修改。
2. Node.js符号链接目录
   安装向导让你选择的路径，是nvm管理node版本的软链接目录，可以自定义，例如修改到 D:\nodejs。
3. 安装完成后，打开cmd或者PowerShell，输入下面命令验证是否安装成功：

    nvm version

输出版本号即为安装成功。

四、nvm 常用命令大全

🔹基础命令

🔹Node版本管理（最常用）

💡小提示： 执行nvm ls releases时，版本数量很多，默认只展示一部分，会给出提示：Use --no‑limit to show all versions or --limit=# to define your own limit.

# 展示全部可安装版本nvm ls releases --no‑limit# 只展示前50个版本nvm ls releases --limit=50# 只展示前10个版本nvm ls releases --limit=10

🔍快速筛选大版本，不用翻完整列表（Windows cmd）：

# 筛选18.x版本nvm ls releases | findstr "18."# 筛选20.x版本nvm ls releases | findstr "20."# 筛选16.x版本nvm ls releases | findstr "16."

也可以直接安装已知版本，不用查询列表：

nvm install 18.16.0nvm install 20.11.0nvm install latest

🔹镜像与配置命令

✨国内网络建议配置淘宝镜像，下载速度大幅提升

命令	说明	示例
nvm node_mirror	设置node下载镜像源	nvm node_mirror https://npm.taobao.org/mirrors/node/
nvm npm_mirror	设置npm下载镜像源	nvm npm_mirror https://npm.taobao.org/mirrors/npm/
nvm root [路径]	查看/修改nvm根存储目录	nvm root D:\nvm
nvm arch	查看当前系统架构32/64位	nvm arch
nvm proxy [url]	查看/设置代理	nvm proxy http://127.0.0.1:10809

🔹其他实用命令

五、简单上手实操流程

1. 设置国内镜像源（必做，解决下载慢）

nvm node_mirror https://npm.taobao.org/mirrors/node/nvm npm_mirror https://npm.taobao.org/mirrors/npm/

1. 安装需要的node版本

nvm install 18.16.0

1. 切换使用该版本

nvm use 18.16.0

1. 查看已安装版本确认

nvm list

📝常见小提醒

1. 运行命令行建议使用管理员身份，避免权限不足报错；
2. 切换node版本后新开终端窗口才会生效；
3. 不要手动去修改nvm的文件夹内文件，全部使用nvm命令操作。