做前端开发，经常会遇到不同项目要求 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
📌版本选择指南
| 安装包 | 适用场景 | 备注 |
|---|---|---|
| nvm‑2.0.0‑amd64‑setup.exe（推荐） | 64 位 (x64) Windows 系统，绝大多数现代电脑 | 图形化安装向导，自动配置环境变量，普通用户首选 |
| nvm‑2.0.0‑amd64‑sync.exe | 64 位系统，离线 / 手动管理场景 | 不会自动配置环境变量，普通用户不建议使用 |
| nvm‑2.0.0‑arm64‑setup.exe | ARM 架构 Windows（Surface Pro X、ARM 笔记本） | 仅 ARM 处理器，Intel/AMD 电脑不要下载 |
| nvm‑2.0.0‑arm64‑sync.exe | ARM 架构离线同步模式 | 普通用户无需考虑 |
✅如何确认自己电脑系统架构： 打开 设置 → 系统 → 关于，查看系统类型字段，显示 64 位操作系统，就选择 amd64 版本。
三、安装 nvm
- 找到下载好的
nvm‑2.0.0‑amd64‑setup.exe，右键→以管理员身份运行。
⚠️两个重要目录区分，千万别搞混：
-
nvm 自身安装目录 ：程序强制固定路径：
C:\Users\你的用户名\AppData\Local\Author Software\nvm，安装过程无法修改。 -
Node.js 符号链接目录 ：安装向导让你选择的路径，是 nvm 管理 node 版本的软链接目录，可以自定义，例如修改到
D:\nodejs。 -
安装完成后，打开 cmd 或者 PowerShell，输入下面命令验证是否安装成功：
nvm version
输出版本号即为安装成功。
四、nvm 常用命令大全
🔹基础命令
| 命令 | 说明 | 示例 |
|---|---|---|
| nvm version | 查看 nvm 自身版本 | nvm version |
| nvm help | 查看全部帮助信息 | nvm help |
🔹Node 版本管理（最常用）
| 命令 | 说明 | 示例 |
|---|---|---|
| nvm install <版本号> | 安装指定 Node 版本 | nvm install 18.16.0 |
| nvm install latest | 安装 Node 最新稳定版 | nvm install latest |
| nvm uninstall <版本号> | 卸载本地已有的指定版本 | nvm uninstall 16.14.0 |
| nvm use <版本号> | 切换使用指定 Node 版本 | nvm use 18.16.0 |
| nvm list / nvm ls | 查看本机已经安装的 Node 版本 | nvm list |
| nvm ls releases | 查看线上可安装的 Node 版本（推荐，旧命令 list available 已废弃） | nvm ls releases |
💡小提示： 执行
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.0
nvm install 20.11.0
nvm install latest🔹镜像与配置命令
✨国内网络建议配置淘宝镜像，下载速度大幅提升 | 命令 | 说明 | 示例 | | ---- | ---- | ---- | |nvm node_mirror <url>| 设置 node 下载镜像源 |
nvm node_mirror https://npm.taobao.org/mirrors/node/| |nvm npm_mirror <url>| 设置 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|
🔹其他实用命令
| 命令 | 说明 | 示例 |
|---|---|---|
| nvm on | 开启 nvm 版本管理功能 | nvm on |
| nvm off | 关闭 nvm 版本管理功能 | nvm off |
| nvm current | 查看当前正在使用的 Node 版本 | nvm current |
| nvm unload | 从环境变量移除 nvm（不是删除文件） | nvm unload |
五、简单上手实操流程
-
设置国内镜像源（必做，解决下载慢）
nvm node_mirror https://npm.taobao.org/mirrors/node/
nvm npm_mirror https://npm.taobao.org/mirrors/npm/ -
安装需要的 node 版本
nvm install 18.16.0
-
切换使用该版本
nvm use 18.16.0
-
查看已安装版本确认
nvm list
📝常见小提醒
- 运行命令行建议使用管理员身份，避免权限不足报错；
- 切换 node 版本后新开终端窗口才会生效；
- 不要手动去修改 nvm 的文件夹内文件，全部使用 nvm 命令操作。