一、NVM介绍
什么是nvm?
nvm 是 Node.js 版本管理器,本质是一个命令行工具,能帮你在同一台电脑上: 安装多个不同版本的 Node.js(比如同时装 v20、v22、v24);
- 一键切换正在使用的 Node 版本(不用手动卸载 / 重装);
- 全局管理 Node 版本,避免不同项目因版本要求不同而冲突。
- ~ 简单类比:nvm 就像电脑里的「Node 版本抽屉」,你可以把不同版本的 Node 放进不同抽屉,想用哪个就打开哪个抽屉,不用每次都重新买(安装)。
nvm的作用?
- 解决版本兼容问题:比如你之前的项目要求 Node ≥22.13.0,而你装了 22.4.0,用 nvm 只需 nvm install 22.13.0 && nvm use 22.13.0 就能一键切换,不用手动卸载重装;
- 多项目版本隔离:如果同时开发 2 个项目 ------A 项目要求 Node 18.x,B 项目要求 Node 24.x,用 nvm 切换版本即可,无需反复调整系统环境;
- 无需管理员权限:安装 / 切换版本时不用跑管理员命令,所有文件都在用户目录下,避免系统级权限问题;
- 一键安装 / 卸载:不用去官网下载安装包,一条命令就能安装指定版本,卸载也只需 nvm uninstall 版本号。
二、下载安装

进入下载模块,确保稳定,可以不用下载最新版

打开安装文件,按照指引下一步等待程序安装完成
可以记录下安装地址,以便配置环境变量,可以参考:nodejs开发环境配置【1】-nvm的安装详解



验证nvm安装情况
nvm --version
有输出显示版本信息即安装成功

三、注意:Windows 和 Linux/macOS 的 nvm 不同
两者必须明确区分:

nvm ls-remote 会提示「不是有效命令」------ 这个命令是 Linux/macOS 版 nvm 的,Windows 版要用 nvm list available 替代。
四、nvm 核心使用场景

# Windows/Linux/macOS 通用(版本号替换即可)
nvm install 22.13.0
# 安装 LTS 长期支持版(推荐,稳定性高)
nvm install lts/iron # iron 是 Node 24.x LTS 的代号
# 切换 Node 版本:适配不同项目
nvm use 22.13.0 # 切换到 22.13.0
nvm use lts/iron # 切换到 24.x LTS
# 查看已安装版本:确认当前有哪些版本
nvm ls # Windows/Linux/macOS 通用
# 查看可安装版本:找需要的版本号
# Windows
nvm list available
# Linux/macOS
nvm ls-remote
# 卸载无用版本:清理磁盘
nvm uninstall 22.4.0
# 卸载你之前的低版本 Node
五、使用 nvm 的注意事项(避坑)
-
安装 nvm 前,必须卸载系统中已安装的 Node.js,否则会冲突;
-
切换 Node 版本后,必须重启终端,新版本才会生效;
-
Windows 版 nvm 安装路径不要包含中文 / 空格(比如不要装到「桌面 / 我的文件夹」),否则会报错;
-
下载 Node 慢时,优先配置国内镜像(淘宝源):
nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/