Terminal integrado
O terminal executa comandos e mostra saídas que ajudam a verificar builds, testes, arquivos e ambiente.
Antes de executar
Saiba qual pergunta o comando responde. Um comando destrutivo ou que altera o ambiente merece contexto claro antes da execução.
Depois
- Observe código de saída e erro relevante.
- Leve a conclusão importante de volta para a sessão.
- Não confunda muito log com validação bem feita.
Saída de terminal é prova
Terminal não é decoração técnica. Build, teste, lint, migration e comando de execução fornecem evidência direta sobre o estado do projeto.
- Preserve stderr, exit code e comando executado quando a falha precisa ser diagnosticada.
O papel desta página
Use Terminal integrado como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O terminal executa comandos e mostra saídas que ajudam a verificar builds, testes, arquivos e ambiente. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.
Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Terminal integrado o estado deixou de corresponder ao que a interface prometia.
No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.
- trate mensagens de erro como dados de diagnóstico, não como detalhe visual
- revise a saída no mesmo ambiente em que ela será usada
- confirme o estado antes de iniciar a próxima ação
Uso no dia a dia
Comece por “Antes de executar”, confirme o estado visível e avance para “Depois” apenas quando a etapa anterior estiver estável. Em Terminal integrado, pular contexto costuma gerar mais retrabalho do que velocidade.
Armadilhas comuns
Imagine uma tarefa real em que Terminal integrado deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.
Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Terminal integrado realmente exigir mais contexto, controle ou verificação.
- confirme o estado antes de iniciar a próxima ação
- mantenha arquivos, sessão e contexto ligados ao mesmo objetivo
- trate mensagens de erro como dados de diagnóstico, não como detalhe visual
Conferência antes de seguir
Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Terminal integrado o estado deixou de corresponder ao que a interface prometia.
Use Terminal integrado como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O terminal executa comandos e mostra saídas que ajudam a verificar builds, testes, arquivos e ambiente. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.
Guia de verificação: Terminal integrado
Nesta página, a referência completa cobre comandos, working directory, stdout/stderr, exit code e honestidade de execução. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.
- confirme o estado inicial antes de executar a ação
- identifique quais dados ou arquivos a superfície realmente possui
- trate loading, vazio, erro, retry e reentrada como comportamento principal
- verifique o resultado no mesmo contrato que o usuário consegue observar
Casos de borda de Terminal integrado
A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.
