Comandos CLI

O Volta fornece um rico conjunto de comandos de linha de comando para ajudá-lo a gerenciar sua cadeia de ferramentas JavaScript.

Comandos Principais

volta install

Instala ferramentas em sua cadeia de ferramentas.

# Instalar a versão LTS mais recente do Node.js
volta install node

# Instalar uma versão específica do Node.js
volta install node@16.14.2

# Instalar a versão mais recente do npm
volta install npm

# Instalar uma versão específica do yarn
volta install yarn@1.22.19

# Instalar pacotes globalmente
volta install typescript
volta install @vue/cli

Opções:

• --verbose: Habilita diagnósticos detalhados
• --quiet: Previne saída desnecessária

volta uninstall

Desinstala ferramentas de sua cadeia de ferramentas.

# Desinstalar Node.js
volta uninstall node

# Desinstalar npm
volta uninstall npm

# Desinstalar pacote
volta uninstall typescript

volta pin

Fixar ferramentas no package.json do seu projeto.

# Fixar Node.js
volta pin node@16.14.2

# Fixar npm
volta pin npm@8.5.0

volta list

Lista ferramentas disponíveis em sua cadeia de ferramentas.

# Listar todas as ferramentas
volta list all

# Listar versões do Node.js instaladas
volta list node

# Listar gerenciadores de pacotes instalados
volta list npm
volta list yarn

# Listar pacotes instalados
volta list packages

volta which

Mostra o caminho da ferramenta especificada que o Volta usará.

volta which node
volta which npm
volta which typescript

volta run

Executa comandos com versões personalizadas de ferramentas.

# Executar com uma versão específica do Node.js
volta run --node 14 node index.js

# Executar com uma versão específica do npm
volta run --npm 6 npm install

# Usar Node.js e npm personalizados simultaneamente
volta run --node 14 --npm 6 npm install

Comandos Adicionais

volta completions

Gera scripts de completação do shell.

# Gerar completação bash
volta completions bash > volta.bash

# Gerar completação zsh
volta completions zsh > _volta

# Gerar completação fish
volta completions fish > volta.fish

volta setup

Configura o Volta em seu ambiente.

# Configurar Volta com configurações padrão
volta setup

# Configurar volta sem modificar arquivos de configuração
VOLTA_SKIP_SETUP=1 volta setup

volta help

Mostra ajuda para comandos do Volta.

# Ajuda geral
volta help

# Ajuda para comando específico
volta help install
volta help pin

Códigos de Saída

Comandos do Volta retornam os seguintes códigos de saída:

• 0: Sucesso
• 1: Erro genérico
• 2: Erro de argumentos de linha de comando
• Números maiores: Erros específicos do comando

Variáveis de Ambiente

Estas variáveis de ambiente afetam o comportamento do Volta ao executar comandos:

• VOLTA_HOME: Diretório onde o Volta armazena dados
• VOLTA_LOGLEVEL: Nível de detalhamento dos logs (error, warn, info, verbose, debug)
• VOLTA_SKIP_SETUP: Pula modificação de arquivos de configuração do shell durante setup
• VOLTA_FEATURE_PNPM: Habilita suporte ao pnpm