What are the most useful NVM (Node Version Manager) commands every developer should know?

在当今前端与后端开发领域，Node.js已成为不可或缺的运行环境。然而，不同项目对Node.js版本的需求各异——有的依赖旧版LTS，有的需要最新特性，频繁切换版本成为开发者的日常痛点。Node Version Manager（NVM）应运而生，它能够在同一台机器上安装、管理、切换多个Node.js版本，极大提升开发效率。但面对众多NVM命令，哪些才是真正高频且必备的？本文将为你逐一解析。

一、NVM基础：安装与版本确认

在深入命令之前，需确保NVM已正确安装。对于macOS和Linux用户，最常用的安装方式是通过curl或wget执行官方安装脚本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装完毕后，通过nvm --version验证版本号。若提示“command not found”，需重新加载shell配置：source ~/.bashrc 或 source ~/.zshrc。

二、核心命令：安装、切换与卸载

1. 查看可安装的Node.js版本

nvm ls-remote

该命令列出所有远程可用的Node.js版本，包括LTS（长期支持版）和最新版。配合--lts参数可只显示LTS版本：nvm ls-remote --lts。

2. 安装指定版本

nvm install 18.17.0   # 安装具体版本
nvm install 20        # 安装主版本号对应的最新版
nvm install node      # 安装最新稳定版

安装完成后，NVM会自动设为当前使用的版本。

3. 查看已安装版本

nvm ls

显示本地所有已安装的Node.js版本，当前使用的版本前会有箭头标记（->）。

4. 切换当前Shell使用的版本

nvm use 16.20.2        # 临时切换到指定版本
nvm use --lts          # 切换到最新LTS版本
nvm use system         # 切换回系统自带版本（如有）

切换只影响当前终端会话，新开终端仍恢复默认版本。

5. 设置默认版本

nvm alias default 18.17.0

为每个新终端会话指定默认使用的Node.js版本。如果不设置，默认使用系统版本或NVM安装的第一个版本。

6. 卸载指定版本

nvm uninstall 14.21.3

当某个版本不再需要时，使用此命令彻底清除，释放磁盘空间。

三、高级实用技巧

1. 根据项目自动切换版本：`.nvmrc`文件

在项目根目录创建.nvmrc文件，写入所需版本号，例如20.11.0或lts/hydrogen。然后运行：

nvm use

NVM会自动读取.nvmrc中的版本并切换，避免手动输入。配合nvm install命令，可在进入项目时自动安装缺失版本。

2. 运行指定版本而不切换

nvm run 16 --version   # 使用Node 16运行命令
nvm exec 18 npm test   # 在Node 18环境下执行npm test

适合临时测试不同版本的兼容性，不改变当前环境。

3. 查看当前版本与路径

nvm current            # 输出当前使用的Node版本
which node             # 查看node可执行文件路径（通常指向~/.nvm/versions/...）

4. 列出所有可用的别名

nvm alias

系统预设了node（最新版）、lts/*（最新LTS）等别名，开发者也可自定义别名，例如nvm alias prod 18.17.0。

四、常见问题与最佳实践

Windows用户注意：NVM官方不支持Windows，但可使用nvm-windows（github.com/coreybutler/nvm-windows），命令略有差异。
磁盘空间管理：定期用nvm ls查看已安装版本，删除长期不用的旧版。使用nvm cache clear清理下载缓存。
权限问题：NVM通过用户目录安装，无需sudo，若遇到EACCES错误，检查是否为全局安装包权限问题，而非NVM本身。
与包管理器协同：切换Node版本后，全局安装的npm包（如yarn、create-react-app）通常需要重新安装，因为这些包绑定在特定版本的npm全局目录下。建议使用nvm reinstall-packages命令（非内置，需手动脚本）或重新全局安装常用工具。

五、总结：NVM命令速查表

命令	作用
`nvm install <version>`	安装指定Node版本
`nvm use <version>`	临时切换版本
`nvm alias default <version>`	设置默认版本
`nvm ls`	列出已安装版本
`nvm ls-remote`	列出远程可用版本
`nvm uninstall <version>`	卸载版本
`nvm current`	显示当前版本
`nvm run <version> <cmd>`	用指定版本运行命令
`nvm exec <version> <cmd>`	在指定版本环境中执行命令

掌握这些命令，开发者即可在多个Node.js项目中游刃有余。无论你是刚接触Node的新人，还是管理数十个微服务的老手，NVM都是工具箱中不可或缺的利器。立即检查你的NVM版本，更新命令储备，让版本切换不再是开发路上的绊脚石。