volta setup

volta setup 命令将通过修改当前用户的 PATH（以平台相关的方式）来启用 Volta，以包含 Volta 垫片目录。它具有以下语法：

为当前用户启用 Volta

用法：
    volta setup [FLAGS]

标志：
        --verbose    启用详细诊断
        --quiet      防止不必要的输出
    -h, --help       打印帮助信息

Unix 设置

在 Unix 系统（macOS 和 Linux）上，volta setup 将使用以下列表搜索配置文件脚本：

• ~/.profile
• ~/.bash_profile
• ~/.bashrc
• ~/.zshrc
• ~/.config/fish/config.fish
• PROFILE 环境变量的值

对于这些存在的文件，volta setup 将修改它们以包含以下行：

1. 定义 VOLTA_HOME 环境变量（通常设置为 ~/.volta）
2. 将 $VOLTA_HOME/bin 添加到 PATH 环境变量

如果您当前 shell 的配置文件（使用 $SHELL 环境变量检测）不存在，如果可能的话，它将使用适当的内容创建。

Windows 设置

在 Windows 上，volta setup 将修改用户 Path 环境变量以包含垫片目录（%LOCALAPPDATA%\Volta\bin）。这确保 Volta 命令在所有命令提示符中都可用。

示例

基本设置

# 运行设置过程
volta setup

这将更新您的 shell 配置文件并使 Volta 在您的 shell 中可用。

静默设置

# 使用最少输出运行设置
volta setup --quiet

何时使用

volta setup 命令在几种情况下很有用：

1. 全新安装后：首次安装 Volta 后运行
2. 删除 Shell 配置后：如果您手动编辑了 shell 配置文件并删除了 Volta 的配置
3. 新用户：在系统上为新用户设置 Volta 时
4. Shell 更改后：如果您已切换到不同的 shell

设置添加到您的配置文件的内容

对于 bash/zsh/sh，volta setup 添加类似的行：

export VOLTA_HOME="$HOME/.volta"
export PATH="$VOLTA_HOME/bin:$PATH"

对于 fish shell，它添加：

set -gx VOLTA_HOME "$HOME/.volta"
set -gx PATH "$VOLTA_HOME/bin" $PATH

手动设置

如果您不想使用 volta setup，可以手动将 Volta 添加到您的 PATH：

1. 创建 Volta 主目录（在 Unix 上默认为 ~/.volta，在 Windows 上为 %LOCALAPPDATA%\Volta）
2. 将 bin 目录添加到您的 PATH 环境变量
3. 重新加载您的 shell 或重启您的终端

故障排除

如果运行 volta setup 后 Volta 不可用：

1. 确保您已打开一个新的终端窗口
2. 检查 Volta 的 bin 目录是否在您的 PATH 中（在 Unix 上使用 echo $PATH，在 Windows 上使用 echo %PATH%）
3. 验证 Volta 主目录是否存在
4. 对于 Unix 系统，检查您的 shell 配置文件是否被正确修改