설치 프로그램

关于安装程序如何工作以及如何创建自己的自定义安装程序/分发版本进行托管安装的详细信息。

当前安装程序

截至 Volta 0.7.0，所有官方安装程序都以相同方式工作：

1. 解压 Volta 二进制文件
2. 使用解压的 volta 二进制文件调用 volta setup（更多信息请参见 volta setup）

Windows 安装程序

Windows 安装程序将所有二进制文件解压到 Program Files\Volta 并将该文件夹添加到系统 Path 环境变量中。它还将在该目录中为以下工具创建垫片：

• node
• npm
• npx
• yarn

Unix 安装程序

Unix 安装程序将所有二进制文件解压到 ~/.volta/bin，因此它们只为特定用户安装。

跳过 Volta 设置

如果您希望运行安装程序但不希望 volta setup 修改您的配置文件脚本，可以向安装程序传递 --skip-setup 选项：

curl https://get.volta.sh | bash -s -- --skip-setup

WARNING

我们目前不支持在 Windows 上跳过 volta setup。

Github CI

为了方便起见，我们提供了一个自定义 Github action，它将自动下载 Volta，缓存它，并下载项目 package.json 中固定版本的工具。

安装旧版本

get.volta.sh 提供的默认安装程序脚本仅支持安装 Volta 1.1.0 及以上版本。如果您希望安装较旧的版本，可以在 Unix 上使用以下脚本安装，将 1.0.8 替换为您要安装的版本：

curl https://raw.githubusercontent.com/volta-cli/volta/8f2074f423c65405dfba9858d9bcf393c38ffb45/dev/unix/volta-install.sh | bash -s -- --version 1.0.8

对于 Windows，您可以下载并安装特定版本的安装程序 .msi 文件。

WARNING

Volta 不支持降级，所以要降级，您需要完全卸载 Volta，然后安装较低版本。

自定义安装程序

要创建自定义安装程序/分发方法，有两个必须步骤和一个可选步骤：

分发二进制文件

二进制文件本身需要传递到目标机器。发布文件中的 volta.manifest 将列出必要的二进制文件列表。截至 Volta 0.7.0，所需文件为：

• volta[.exe]
• volta-shim[.exe]
• volta-migrate[.exe]

这些二进制文件都需要分发在同一目录中，并且该目录应该在 PATH 中，以便对 volta 命令的调用能正常工作。

垫片目录

Volta 垫片目录也需要添加到 PATH 中，以便垫片也能按预期工作。垫片目录位于 $VOLTA_HOME/bin（Windows 上为 %VOLTA_HOME%\bin），其中 VOLTA_HOME 默认为：

• Unix 上为 ~/.volta
• Windows 上为 %LOCALAPPDATA%\Volta

如果需要，可以手动管理 PATH 更新，或者可以调用 volta setup（如官方安装程序所做的，如上所述）。

自定义 Volta 主目录（可选）

如果您希望为 Volta 数据使用不同于上一节中列出的默认 VOLTA_HOME 的目录，您需要将环境变量 VOLTA_HOME 设置为该目录。如果设置了该变量，则 volta setup 对于自定义数据目录仍然可以正常工作。