环境变量

Volta 遵循几个控制其行为的环境变量。本页面作为所有可用环境变量及其影响的参考。

核心环境变量

VOLTA_HOME

设置 Volta 存储其数据的目录，包括下载的工具和配置。

• 默认值:
  • Unix: $HOME/.volta
  • Windows: %LOCALAPPDATA%\Volta
• 示例: VOLTA_HOME=/opt/volta

VOLTA_LOGLEVEL

控制 Volta 日志输出的详细程度。

• 有效值: error、warn、info、verbose、debug
• 默认值: info
• 示例: VOLTA_LOGLEVEL=debug volta install node

VOLTA_SKIP_SETUP

当设置为 1 时，防止 Volta 在安装期间修改 shell 配置文件。

• 有效值: 0、1
• 默认值: 0
• 示例: VOLTA_SKIP_SETUP=1 bash -c "$(curl https://get.volta.sh)"

功能标志

VOLTA_FEATURE_PNPM

在 Volta 中启用 pnpm 支持。

• 有效值: 0、1
• 默认值: 0
• 示例: VOLTA_FEATURE_PNPM=1 volta install pnpm

网络配置

VOLTA_NETWORK_TIMEOUT_SECS

设置网络操作的超时时间（秒）。

• 默认值: 60
• 示例: VOLTA_NETWORK_TIMEOUT_SECS=120 volta install node

HTTP_PROXY / HTTPS_PROXY

Volta 用于网络请求的标准代理环境变量。

• 示例:
  • HTTP_PROXY=http://proxy.example.com:8080
  • HTTPS_PROXY=http://proxy.example.com:8080

NO_PROXY

应绕过代理的主机的逗号分隔列表。

• 示例: NO_PROXY=localhost,127.0.0.1,.example.com

安装变量

VOLTA_LATEST_VERSION

强制 Volta 安装程序使用特定版本而不是最新版本。

• 示例: VOLTA_LATEST_VERSION=1.0.5 bash -c "$(curl https://get.volta.sh)"

VOLTA_TARGET_PROFILE

指定安装程序应修改哪个 shell 配置文件。

• 默认值: 基于当前 shell 自动检测
• 示例: VOLTA_TARGET_PROFILE=$HOME/.bashrc

平台特定变量

VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK

更新通知中兼容性检查的最小 Volta 版本。

• 示例: VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK=1.0.5

Windows 特定变量

这些变量仅在 Windows 系统上使用：

VOLTA_REDIRECT_STDERR

当设置为 1 时，在 Windows 上将 stderr 输出重定向到 stdout。

• 有效值: 0、1
• 默认值: 0

高级用法

VOLTA_UNSAFE_DIAGNOSTIC

用于调试；启用可能不稳定的高级诊断。

• 有效值: 任何字符串
• 示例: VOLTA_UNSAFE_DIAGNOSTIC=timing volta install node

VOLTA_STDIN_FILE_PASSTHROUGH

设置后，Volta 将使用此文件路径而不是 stdin 进行脚本执行。

• 示例: VOLTA_STDIN_FILE_PASSTHROUGH=/tmp/script.js volta run node

示例配置

开发环境

对于带有详细日志的开发设置：

export VOLTA_HOME=$HOME/.volta
export VOLTA_LOGLEVEL=verbose
export PATH=$VOLTA_HOME/bin:$PATH

CI/CD 流水线

对于持续集成环境：

export VOLTA_HOME=$HOME/.volta
export VOLTA_LOGLEVEL=error
export VOLTA_NETWORK_TIMEOUT_SECS=300
export PATH=$VOLTA_HOME/bin:$PATH

企业网络

对于有代理服务器的环境：

export VOLTA_HOME=$HOME/.volta
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1,.internal.example.com
export PATH=$VOLTA_HOME/bin:$PATH