O conteúdo preparado no índice
O stage é a área de preparação do Git que guarda o conteúdo selecionado para o próximo commit. Ela também é chamada de índice ou staging area. O comando git add atualiza essa área com o conteúdo do arquivo naquele momento, permitindo preparar uma alteração e continuar editando o mesmo arquivo.
O índice descreve a versão preparada do projeto, incluindo o conteúdo que já estava registrado e as mudanças selecionadas. No uso comum de git commit, é essa versão preparada que o Git registra. As edições feitas depois do último git add permanecem no diretório de trabalho até você incluí-las.
Duas versões do mesmo arquivo
Neste exemplo didático, formulario.js já é rastreado pelo Git e recebeu uma correção. Você prepara o arquivo e confere a mudança:
git add formulario.jsgit diff --cached -- formulario.jsO primeiro comando atualiza o índice com o conteúdo atual de formulario.js. O segundo compara essa versão preparada com o último commit e exibe as linhas que serão alteradas no arquivo pelo próximo commit comum.
Após essa preparação, você pode acrescentar uma validação no editor. Essa nova edição fica fora do índice até outro git add. Para examiná-la, use git diff -- formulario.js, que compara o arquivo de trabalho com a versão preparada.
Você pode conferir a correção preparada com --cached e a validação ainda não preparada com o comando sem essa opção. Para incluir a validação no próximo commit, execute novamente git add formulario.js depois de revisar o arquivo.
Dúvidas frequentes
Perguntas frequentes sobre stage
- É possível preparar só parte de um arquivo?
- Sim. O comando git add -p apresenta trechos das alterações para você selecionar quais entram no índice. O restante continua no diretório de trabalho.
- Por que o mesmo arquivo aparece como preparado e modificado?
- O índice pode conter uma versão preparada com git add e o arquivo pode ter recebido outras edições depois. O git status mostra as duas situações porque elas representam comparações diferentes.
- Stage é o ambiente de homologação?
- Aqui, stage significa a área de preparação do Git, também chamada de índice. Um ambiente de homologação é uma instalação da aplicação para testes e não corresponde a essa área do repositório.
Para continuar
Recursos relacionados
Documentação
Git: conteúdo preparado para o commit
Explica como o git add registra o conteúdo no índice e permite selecionar parte das alterações.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Orientação ao vivo para revisar o conteúdo preparado para commit e separar alterações durante o trabalho no repositório.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Conferir o stage permite revisar quais alterações feitas por você ou por agentes serão incluídas no próximo commit.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.