volta setup
O comando volta setup
irá habilitar o Volta modificando o PATH
do usuário atual (de forma específica da plataforma) para incluir o diretório de shims do Volta. Ele tem a seguinte sintaxe:
Habilitar Volta para o usuário atual
Uso:
volta setup [FLAGS]
Flags:
--verbose Habilitar diagnósticos detalhados
--quiet Prevenir saída desnecessária
-h, --help Imprimir informações de ajuda
Configuração Unix
Em sistemas Unix (macOS e Linux), volta setup
irá procurar por scripts de configuração usando a seguinte lista:
~/.profile
~/.bash_profile
~/.bashrc
~/.zshrc
~/.config/fish/config.fish
- Valor da variável de ambiente
PROFILE
Para esses arquivos que existem, volta setup
irá modificá-los para incluir as seguintes linhas:
- Definir a variável de ambiente
VOLTA_HOME
(geralmente definida como~/.volta
) - Adicionar
$VOLTA_HOME/bin
à variável de ambientePATH
Se o arquivo de configuração do seu shell atual (detectado usando a variável de ambiente $SHELL
) não existir, ele será criado com conteúdo apropriado se possível.
Configuração Windows
No Windows, volta setup
irá modificar a variável de ambiente Path
do usuário para incluir o diretório de shims (%LOCALAPPDATA%\Volta\bin
). Isso garante que comandos do Volta estejam disponíveis em todos os prompts de comando.
Exemplos
Configuração Básica
# Executar processo de configuração
volta setup
Isso atualizará seus arquivos de configuração do shell e tornará o Volta disponível em seu shell.
Configuração Silenciosa
# Executar configuração com saída mínima
volta setup --quiet
Quando Usar
O comando volta setup
é útil em várias situações:
- Após instalação nova: Executar após instalar o Volta pela primeira vez
- Após remoção de configuração do shell: Se você editou manualmente arquivos de configuração do shell e removeu a configuração do Volta
- Novo usuário: Ao configurar o Volta para um novo usuário no sistema
- Após mudança de shell: Se você mudou para um shell diferente
Conteúdo Adicionado aos Seus Arquivos de Configuração
Para bash/zsh/sh, volta setup
adiciona linhas similares a:
export VOLTA_HOME="$HOME/.volta"
export PATH="$VOLTA_HOME/bin:$PATH"
Para o shell fish, ele adiciona:
set -gx VOLTA_HOME "$HOME/.volta"
set -gx PATH "$VOLTA_HOME/bin" $PATH
Configuração Manual
Se você não quiser usar volta setup
, pode adicionar o Volta ao seu PATH manualmente:
- Criar diretório principal do Volta (padrão
~/.volta
no Unix,%LOCALAPPDATA%\Volta
no Windows) - Adicionar o diretório bin à sua variável de ambiente PATH
- Recarregar seu shell ou reiniciar seu terminal
Solução de Problemas
Se o Volta não estiver disponível após executar volta setup
:
- Certifique-se de que você abriu uma nova janela de terminal
- Verifique se o diretório bin do Volta está em seu PATH (use
echo $PATH
no Unix,echo %PATH%
no Windows) - Verificar se o diretório principal do Volta existe
- Para sistemas Unix, verificar se seus arquivos de configuração do shell foram modificados corretamente