NVM 快速上手教程：多版本 Node 管理神器

一、什么是 NVM

NVM 全称 Node Version Manager，是一款跨平台 Node.js 版本管理工具。

日常开发中，不同项目往往依赖不同 Node 版本：

• 老旧项目需要 Node14 / Node16
• 新项目、Vite / VitePress 等工程推荐 Node18+ / Node20

如果全局只装一个 Node，极易出现依赖报错、打包失败、环境冲突等问题。

借助 NVM 可以实现：

• 一台电脑共存多个 Node 版本
• 一条命令快速切换版本
• 单独为项目锁定 Node 版本
• 彻底解决 Node 环境版本冲突

二、NVM 下载地址

🔹 Windows 下载（nvm-windows）

• nvm-setup.zip

三、NVM 常用命令大全（必记）

基础验证命令

# 查看 nvm 版本，验证安装成功（大小写均可）
nvm -v
nvm --version

版本查询与安装

# 查看所有可安装的 Node 版本（分页显示，按空格键翻页，q 退出）
nvm list available

# 安装指定版本（推荐安装 LTS 稳定版，示例：Node18、Node20）
nvm install 18.19.0  # 安装具体版本
nvm install 20.12.2  # 安装最新稳定版
nvm install --lts    # 一键安装最新 LTS 版本（推荐）

版本切换与管理

# 切换使用某个已安装的 Node 版本（需管理员权限，Windows 建议用管理员终端）
nvm use 18          # 切换到 18.x 系列（自动匹配已安装的最新18版本）
nvm use 20.12.2     # 切换到具体版本

# 查看本地已安装的所有 Node 版本（* 标识当前正在使用的版本）
nvm list
nvm ls              # 简写形式

# 设置默认开机全局版本（避免重启终端后版本重置）
nvm alias default 20  # 将 Node20 设为默认版本

版本卸载与清理

# 卸载指定 Node 版本（需先切换到其他版本，不能卸载当前正在使用的版本）
nvm uninstall 18.19.0

# 查看当前使用的 Node 版本路径
nvm which 20.12.2

四、安装注意事项

1. 安装 NVM 前，先卸载电脑本地已有的独立 Node，防止环境冲突
2. Windows 建议使用管理员权限安装/运行终端，否则可能出现“切换版本失败”
3. 安装完成后必须重启终端，环境变量才能生效
4. 下载 Node 速度慢时，可配置淘宝镜像加速

---