安装

相关源文件

• .dockerignore
• Dockerfile
• README.md
• ROADMAP.md
• nvm-exec
• test/fast/单元测试/nvm_alias_path
• test/sourcing/Sourcing nvm.sh with --no-use should not use anything

本页面介绍如何在各种平台和环境中安装 Node Version Manager (NVM)。NVM 是一个 shell 脚本，用于在一用户基础上管理多个 Node.js 版本。本文档涵盖了不同的安装方法、特定于平台的注意事项以及安装后的验证步骤。

安装方法

NVM 可以通过多种方法安装，其中安装脚本是大多数用户的推荐方法。所有方法都产生相同的功能，但获取和设置 NVM 环境的方式有所不同。

安装和更新脚本

安装 NVM 的主要方法是通过安装脚本，该脚本会自动下载必要的文件并配置您的 shell 环境。

或

此脚本执行以下操作：

1. 将 NVM 仓库克隆到 ~/.nvm（或 $XDG_CONFIG_HOME/nvm，如果已定义）。
2. 将适当的 source 行添加到您的 shell profile 文件（~/.bashrc、~/.bash_profile、~/.zshrc 或 ~/.profile）。
3. 设置 NVM 运行所需的必要环境。

来源：README.md105-111

安装流程图

来源：README.md113-119 README.md325-332

安装脚本选项

您可以使用环境变量自定义安装。

• NVM_DIR - 指定安装目录。
• PROFILE - 指定要修改的 profile 文件。
• NVM_SOURCE - 指定仓库源。
• NODE_VERSION - 安装后安装指定的 Node.js 版本。
• 使用 PROFILE=/dev/null 不修改 profile。

自定义目录示例

来源：README.md121-137

Git 安装

为了更好地控制安装过程，您可以直接从 Git 仓库安装 NVM。

1. 将仓库克隆到您的主目录。

2. 检出所需的版本。

3. 通过 source 激活 NVM。

4. 将必要的行添加到您的 shell profile。

来源：README.md317-332

手动安装

完全手动安装

1. 克隆仓库并检出最新版本。
2. Source nvm.sh 脚本。
3. 将必需的行添加到您的 shell profile。

来源：README.md335-344 README.md349-353

安装后配置

安装 NVM 后，您需要确保它在您的 shell 环境中得到正确配置。

Shell Profile 配置

安装脚本会将以下行添加到您的 shell profile：

这些行完成以下操作：

1. 设置 NVM_DIR 环境变量，指向您的 NVM 安装。
2. Source nvm.sh 脚本以启用 NVM 命令。
3. Source bash_completion 以进行命令行补全。

来源：README.md115-119 README.md330-332

NVM Shell 集成图

来源：README.md330-332 README.md831-840

平台特定安装

Linux

在 Linux 系统上，运行安装脚本后，如果找不到 nvm 命令，您可能需要重启终端或 source 您的 profile 文件。

来源：README.md214-226

macOS

在 macOS 上，有一些特定的注意事项：

1. 在运行安装脚本前安装 Xcode 命令行工具。
2. 对于 macOS 10.15+（默认使用 zsh），如果不存在 .zshrc 文件，请创建一个。
3. 对于 bash 用户，如果不存在 .bash_profile 或 .bashrc，您可能需要创建它们。

对于 Apple Silicon (M1/M2) Mac，请注意，Node.js 从 v16.0.0 开始提供 arm64 架构包，从 v14.17.0 开始提供实验性支持。

来源：README.md227-251

Docker

对于 Docker 环境，有两种安装 NVM 的方法：

基本 Docker 安装

对于 Docker 容器，您需要处理非交互式 shell 环境。

来源：README.md139-156 Dockerfile94-101

增强的 Docker 安装，适用于 CI/CD

对于更健壮的 Docker 安装，尤其是在 CI/CD 环境中。

来源：README.md158-202

Alpine Linux

Alpine Linux 由于使用 musl libc 而非 glibc，需要额外的步骤。

Alpine Linux 3.13+

来源：README.md915-924

目录结构

安装后，NVM 会创建以下目录结构：

来源：README.md330-332 nvm-exec1-18

安装验证

安装 NVM 后，通过运行以下命令来验证其是否正常工作：

如果安装成功，这应该会输出 nvm。请注意，which nvm 将无法工作，因为 nvm 是一个 shell 函数，而不是可执行二进制文件。

来源： README.md266-276

重要说明和要求

1. 系统要求:

   • 编译 Node.js 源码：C++ 编译器 (Debian/Ubuntu 上的 build-essential 和 libssl-dev 包，macOS 上的 Xcode)
   • Git v1.7.10+ (用于基于 Git 的安装方法)

2. 平台支持:

   • 完全支持：Unix、macOS 和适用于 Linux 的 Windows 子系统 (WSL)
   • 有限支持：Windows (通过 GitBash 或 Cygwin)
   • Windows 的替代方案：nvm-windows、nodist、nvs (NVM 维护者不提供支持)
   • Fish shell 不直接支持 (需要额外工具)

3. macOS 特有说明:

   • 使用 NVM 时，全局 npm 安装不需要 sudo
   • 确保 ~/.npmrc 不包含 prefix 设置
   • Homebrew 安装 NVM 未获得官方支持

来源： README.md277-313

升级 NVM

要升级现有的 NVM 安装

自动升级

再次运行安装脚本会将 NVM 升级到最新版本

手动升级

使用 Git 进行手动升级

来源： README.md356-370

卸载 NVM

要卸载 NVM，您需要

1. 删除 NVM 目录 (通常是 ~/.nvm)
2. 从您的 shell 配置文件中删除 NVM 源行

有关安装 NVM 后的高级用法和配置，请参阅 用法 和 高级主题。

来源： README.md58-60