在 Devin 中试用 DeepWiki 处理私有仓库
DeepWiki

nvm-sh/nvm

菜单

基本命令

相关源文件

本页面介绍了 Node 版本管理器（NVM）提供的核心命令，这些命令允许您安装、管理和切换多个 Node.js 版本。这些命令构成了 NVM 功能的基础，对于日常使用至关重要。

有关使用 .nvmrc 文件进行项目特定配置的信息，请参阅 项目特定配置 (.nvmrc)。有关使用别名和 LTS 版本进行操作的详细信息，请参阅 别名和 LTS 版本。

命令概述

NVM 提供了几个类别的命令来管理 Node.js 安装

类别目的关键命令
安装安装 Node.js 版本nvm install
版本选择在已安装的版本之间切换nvm use, nvm exec, nvm run
列出查看可用和已安装的版本nvm ls, nvm ls-remote
信息获取已安装版本的信息nvm current, nvm which
别名管理创建和管理版本别名nvm alias, nvm unalias

来源： nvm.sh373-406 README.md373-431

命令流程和交互

下图说明了 NVM 命令如何与系统进行交互

来源： nvm.sh700-735 nvm.sh600-628 nvm.sh980-1004

安装命令

nvm install

nvm install 命令用于下载和安装指定的 Node.js 版本。

基本用法

nvm install <version>

常用选项

选项描述
--reinstall-packages-from=<version>从另一个版本重新安装包
--lts安装最新的 LTS 版本
--latest-npm安装后，升级到最新的 npm 版本
--no-progress隐藏下载进度条

示例

来源： nvm.sh700-735 README.md376-419

版本选择命令

nvm use

nvm use 命令会在当前 shell 中激活指定的 Node.js 版本。

基本用法

nvm use <version>

示例

版本选择过程

来源： nvm.sh700-735 nvm.sh980-1004

nvm exec

nvm exec 命令在不永久更改当前版本的情况下，使用指定的 Node.js 版本运行命令。

基本用法

nvm exec [version] [command]

示例

来源： README.md416-419

nvm run

nvm run 命令使用指定的版本运行 Node.js 脚本。

基本用法

nvm run [version] [script]

示例

来源： README.md408-412

列表和信息命令

nvm ls

nvm ls 命令列出已安装的 Node.js 版本。

基本用法

nvm ls [pattern]

示例

来源： README.md524-528

nvm ls-remote

nvm ls-remote 命令列出可供安装的 Node.js 版本。

基本用法

nvm ls-remote [pattern]

示例

来源： README.md530-534 nvm.sh796-867

nvm current

nvm current 命令显示当前活动的 Node.js 版本。

基本用法

nvm current

来源： nvm.sh739-766

nvm which

nvm which 命令显示指定 Node.js 版本的可执行文件路径。

基本用法

nvm which [version]

示例

来源： README.md420-423

别名管理

NVM 别名是指向特定 Node.js 版本的短名称，方便引用。

来源： nvm.sh682-684 README.md386-392

nvm alias

nvm alias 命令创建或列出 Node.js 版本的别名。

基本用法

nvm alias [name] [version]

示例

来源： README.md386-392

nvm unalias

nvm unalias 命令用于移除先前定义的别名。

基本用法

nvm unalias <name>

示例

特殊命令

nvm install-latest-npm

将 npm 更新到当前 Node.js 版本支持的最新版本。

基本用法

nvm install-latest-npm

来源： nvm.sh197-434 README.md479-482

nvm deactivate

在当前 shell 中停用 NVM，将 PATH 恢复到未经 NVM 修改的原始状态。

基本用法

nvm deactivate

来源： nvm.sh165-166

版本解析逻辑

NVM 通过一个分层过程来解析版本说明符

  1. 显式版本（例如，16.14.0，14.17.3）
  2. 命名别名（您创建的自定义别名）
  3. 隐式别名:
    • node - 最新 Node.js 发布版本
    • iojs - 最新 io.js 发布版本
    • stable - 最新稳定版 Node.js 发布版本
    • lts/* - 最新 LTS 版本
    • lts/[codename] - 指定 LTS 版本系列（例如：lts/gallium）

NVM 总是优先尝试匹配最精确的版本，如果需要则回退到更通用的匹配方式。

来源： nvm.sh739-766 nvm.sh869-884 README.md424-431

常见使用模式

安装和使用特定版本

使用 LTS 版本

管理项目特定版本

来源： README.md437-443 nvm.sh508-514

错误处理

当 NVM 命令遇到问题时，通常会以非零状态码退出并显示错误消息。常见错误包括：

  • 找不到版本：指定的版本不存在或不可用
  • 未安装版本：需要先安装指定的版本
  • 版本格式无效：版本说明符无法识别

发生这些错误时，NVM 通常会建议正确的操作（例如，运行 nvm install）。

关于 Shell 集成的说明

NVM 命令通过修改 PATH 来修改当前 shell 环境。这意味着：

  1. 更改仅影响当前 shell 会话
  2. 新的 shell 会话需要重新运行 nvm use 命令
  3. 要实现自动版本切换，可能需要 shell 钩子来检测 .nvmrc 文件

要实现更深层的 shell 集成，根据 .nvmrc 文件自动使用正确的 Node.js 版本，请参阅 更深层的 Shell 集成。

来源： nvm.sh980-1004 README.md46-52