Passo a passo: Como adicionar arquivos ao stage antes de commitar

Como adicionar arquivos ao stage antes de commitar?

O staging area (ou stage) no Git é uma etapa intermediária entre modificar arquivos e salvar essas mudanças em um commit. Ele permite selecionar quais alterações serão incluídas no próximo commit, evitando adicionar arquivos indesejados por engano.

Adicionando um único arquivo ao stage

Para adicionar um arquivo específico ao stage, utilize:

git add arquivo.txt

Esse comando indica ao Git que arquivo.txt deve ser incluído no próximo commit.

Adicionando múltiplos arquivos ao stage

Caso queira adicionar múltiplos arquivos de uma vez, utilize:

git add arquivo1.txt arquivo2.txt

Isso adiciona ambos os arquivos ao stage simultaneamente.

Adicionando todas as mudanças ao stage

Se deseja adicionar todas as alterações no repositório ao stage, utilize:

git add .

Isso adiciona todas as mudanças (modificações, novos arquivos e arquivos deletados) ao stage.

Verificando arquivos no stage

Antes de criar um commit, é uma boa prática verificar quais arquivos foram adicionados ao stage. Para isso, use:

git status

Esse comando exibe a lista de arquivos no stage e aqueles que ainda não foram adicionados.

Por que a área de stage no Git é essencial?

Adicionar arquivos ao stage antes de commitar é um dos conceitos fundamentais do Git. Ele permite que os desenvolvedores tenham mais controle sobre quais mudanças serão registradas no histórico do projeto, evitando que arquivos indesejados sejam incluídos em commits.

Outro ponto importante é que a área de stage possibilita a criação de commits mais organizados. Se você fez diversas mudanças em diferentes partes do código, pode adicionar apenas algumas ao stage e criar commits separados para manter um histórico mais claro e fácil de entender. Essa prática melhora a manutenção do código e facilita revisões e auditorias.

Algumas aplicações:

• Permitir que apenas arquivos selecionados sejam incluídos no próximo commit
• Facilitar a organização de mudanças em commits distintos
• Evitar que arquivos temporários ou desnecessários sejam versionados
• Garantir que todas as alterações importantes sejam incluídas antes do commit
• Facilitar a revisão de mudanças antes de salvá-las permanentemente

Dicas para quem está começando

• Antes de adicionar arquivos ao stage, use 'git status' para conferir quais arquivos foram modificados.
• Use 'git add .' apenas quando tiver certeza de que deseja adicionar todas as alterações ao commit.
• Se precisar remover um arquivo do stage antes de commitá-lo, use 'git reset arquivo.txt'.
• Divida grandes alterações em commits menores para facilitar a rastreabilidade.
• Experimente usar 'git diff --staged' para visualizar as mudanças que já foram adicionadas ao stage.

Compartilhe este tutorial