快速开始

安装 Volta

Unix 安装

在大多数 Unix 系统（包括 macOS）上，您可以使用一条命令安装 Volta：

curl https://get.volta.sh | bash

对于 bash、zsh 和 fish，此安装程序将自动更新您的控制台启动脚本。如果您希望阻止对控制台启动脚本的修改，请参阅跳过 Volta 设置。要手动配置您的 shell 以使用 Volta，请编辑您的控制台启动脚本：

• 将 VOLTA_HOME 变量设置为 $HOME/.volta
• 将 $VOLTA_HOME/bin 添加到您的 PATH 变量的开头

Windows 安装

对于 Windows，推荐使用 winget 安装 Volta：

winget install Volta.Volta

如果您愿意，也可以直接下载安装程序并手动运行以安装 Volta。

Windows Linux 子系统

如果您在 Windows Linux 子系统中使用 Volta，请按照上面的 Unix 安装指南进行操作。

手动安装

如果您希望手动安装 Volta，可以从下表中下载适合您操作系统的软件包：

平台	软件包与安装说明
Windows x86_64	volta-2.0.2-windows-x86_64.msi 双击 MSI 文件并按照安装向导进行操作。安装程序将自动将 Volta 添加到您的 PATH 中。
Windows ARM64	volta-2.0.2-windows-arm64.msi 双击 MSI 文件并按照安装向导进行操作。安装程序将自动将 Volta 添加到您的 PATH 中。
Windows x86_64 (ZIP)	volta-2.0.2-windows.zip 将 ZIP 文件解压到您选择的位置。将解压的目录添加到您的 PATH 环境变量中。
Windows ARM64 (ZIP)	volta-2.0.2-windows-arm64.zip 将 ZIP 文件解压到您选择的位置。将解压的目录添加到您的 PATH 环境变量中。
macOS x86_64/ARM64	volta-2.0.2-macos.tar.gz 解压 tarball 并运行包含的安装脚本：tar xzf volta-2.0.2-macos.tar.gz && ./volta-2.0.2-macos/install.sh
Linux x86_64	volta-2.0.2-linux.tar.gz 解压 tarball 并运行包含的安装脚本：tar xzf volta-2.0.2-linux.tar.gz && ./volta-2.0.2-linux/install.sh
Linux ARM	volta-2.0.2-linux-arm.tar.gz 解压 tarball 并运行包含的安装脚本：tar xzf volta-2.0.2-linux-arm.tar.gz && ./volta-2.0.2-linux-arm/install.sh

Windows 手动安装步骤

1. 为您的系统架构（x86_64 或 ARM64）下载相应的 MSI 安装程序
2. 双击下载的文件运行安装程序
3. 按照安装向导提示进行操作
4. 安装程序将自动将 Volta 添加到您的系统 PATH
5. 打开一个新的命令提示符或 PowerShell 窗口开始使用 Volta

ZIP 安装方式：

1. 为您的系统架构下载相应的 ZIP 文件
2. 将 ZIP 文件解压到您选择的目录（例如，C:\Program Files\Volta）
3. 将解压的目录添加到您的系统 PATH 环境变量中
4. 打开一个新的命令提示符或 PowerShell 窗口开始使用 Volta

macOS 手动安装步骤

1. 下载 macOS tarball
2. 打开终端并导航到下载位置
3. 解压 tarball 并运行安装脚本：

   tar xzf volta-2.0.2-macos.tar.gz
   ./volta-2.0.2-macos/install.sh

4. 安装脚本将：
   • 将 Volta 二进制文件放置在 ~/.volta/bin 中
   • 更新您的 shell 配置文件以将 Volta 添加到您的 PATH
5. 重启您的终端或运行 source ~/.bashrc（或您相应的 shell 配置文件）

Linux 手动安装步骤

1. 为您的系统架构（x86_64 或 ARM）下载相应的 Linux tarball
2. 打开终端并导航到下载位置
3. 解压 tarball 并运行安装脚本：

   tar xzf volta-2.0.2-linux.tar.gz
   ./volta-2.0.2-linux/install.sh

4. 安装脚本将：
   • 将 Volta 二进制文件放置在 ~/.volta/bin 中
   • 更新您的 shell 配置文件以将 Volta 添加到您的 PATH
5. 重启您的终端或运行 source ~/.bashrc（或您相应的 shell 配置文件）

选择默认的 Node 版本

这是 Volta 在没有固定版本的项目之外到处使用的版本。

要选择特定版本的 Node，请运行：

volta install node@22.5.1

或者要使用最新的 LTS 版本，请运行：

volta install node

使用 Volta 管理您的项目

在您的项目中使用 Volta 很简单。只需运行：

volta pin node@16

这会在您的 package.json 文件中添加一个 volta 部分，确保所有项目成员使用相同版本的 Node.js。

您也可以固定包管理器：

volta pin npm@8

这样，每当在您的项目中运行 npm 时，Volta 都会确保使用指定的版本。