菜单

安装选项

相关源文件

本页面详细介绍了 Node 版本管理器 (NVM) 可用的高级安装配置和选项。它深入解释了安装方法、自定义选项以及控制安装行为的环境变量。有关基本安装说明,请参阅安装页面。

安装方法

NVM 提供多种安装方法,以适应不同的环境和用户偏好。

安装脚本

安装 NVM 的主要方法是使用 curl 或 wget 的安装脚本

安装脚本执行以下操作

来源: test/install_script/nvm_install_with_node_version6-12

手动安装

您也可以手动安装 NVM,方法是

  1. 克隆存储库: git clone https://github.com/nvm-sh/nvm.git ~/.nvm
  2. 检出特定版本: (cd ~/.nvm && git checkout v0.39.3)
  3. 手动将以下内容添加到您的 shell 配置文件中

来源: test/install_script/nvm_source12-17

安装配置选项

自定义安装目录

默认情况下,NVM 安装到 ~/.nvm。您可以通过在运行安装脚本之前设置 NVM_DIR 环境变量来自定义此位置。

示例

来源: test/install_script/nvm_install_dir14-23

自定义源存储库

您可以通过设置 NVM_INSTALL_GITHUB_REPO 环境变量,从自定义 GitHub 存储库安装 NVM

这对于测试 NVM 的分支或替代版本很有用。

来源: test/install_script/nvm_source13-17

自定义 NVM 版本

要安装特定版本的 NVM,请设置 NVM_INSTALL_VERSION 环境变量

这允许您根据需要安装旧版本以确保兼容性。

来源: test/install_script/nvm_source21-25

安装 Node.js 版本

您可以通过设置 NODE_VERSION 环境变量,在安装 NVM 时安装特定版本的 Node.js

这将一步安装 NVM 和指定的 Node.js 版本。

来源: test/install_script/nvm_install_with_node_version6-12

Shell 集成和 Sourcing 选项

NVM 通过将特定代码添加到您的 shell 配置文件(.bashrc.zshrc 等)来集成到您的 shell 中。

Shell 配置文件修改

安装脚本会将以下行添加到您的 shell 配置文件中

这些行可确保每次打开新的 shell 会话时都会加载 NVM。

Sourcing 选项

在 sourcing nvm.sh 时,您可以提供 --no-use 选项以防止 NVM 自动选择 Node.js 版本

当您想加载 NVM 函数但又不想自动切换 Node.js 版本时,此选项非常有用。

来源: test/sourcing/Sourcing nvm.sh with --no-use should not use anything23-31 nvm-exec7-8

安装环境变量

以下环境变量可用于自定义 NVM 安装过程

可变描述默认值
NVM_DIRNVM 的安装目录$HOME/.nvm$XDG_CONFIG_HOME/nvm
NVM_SOURCE下载 NVM 的自定义 URLhttps://github.com/nvm-sh/nvm.git
NVM_INSTALL_GITHUB_REPO要安装的 GitHub 存储库nvm-sh/nvm
NVM_INSTALL_VERSION要安装的特定 NVM 版本最新版本
NODE_VERSION与 NVM 一起安装的 Node.js 版本无(未安装版本)
XDG_CONFIG_HOME用户特定配置的基础目录因系统而异

来源: test/install_script/nvm_source12-41 test/install_script/nvm_install_dir14-23 test/install_script/nvm_install_with_node_version6-12

NVM 目录结构

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

此结构以清晰的层次结构组织 NVM 脚本文件、Node.js 版本和别名。

来源: nvm-exec3-8

安装验证

安装后,您可以运行以下命令来验证 NVM 是否已正确安装

如果安装成功,此命令将输出 nvm。如果它什么都不输出或显示错误,则安装可能存在问题。

来源: test/install_script/nvm_install_with_aliased_dot21-22

排查安装问题

Shell 找不到 NVM 命令

如果在安装后找不到 nvm 命令,请尝试

  1. 关闭并重新打开您的终端
  2. 手动 sourcing NVM: source ~/.nvm/nvm.sh
  3. 检查您的 shell 配置文件是否已正确修改
  4. 正确设置 NVM_DIR: export NVM_DIR="$HOME/.nvm"

安装脚本失败

如果安装脚本失败

  1. 检查您的互联网连接
  2. 确保您具有必需的依赖项(curl、git)
  3. 检查目标目录中的文件权限
  4. 尝试手动安装

自定义 Shell 配置

如果您使用自定义 shell 配置或别名,您可能需要额外的设置

来源: test/install_script/nvm_install_with_aliased_dot6-8