Entenda o comando git add . e como utilizá-lo corretamente

O que significa o comando git add .?

O comando git add . é um dos mais utilizados no Git, pois adiciona todas as mudanças feitas nos arquivos do diretório atual para a staging area. Isso inclui:

• Arquivos novos que ainda não foram rastreados pelo Git.
• Arquivos modificados que já fazem parte do repositório.
• Arquivos excluídos, para que essa remoção seja registrada no próximo commit.

Como utilizar o comando git add .

Para adicionar todas as alterações ao stage, basta executar:

git add .

Isso adicionará todas as modificações detectadas no diretório atual ao stage.

Diferença entre git add . e git add -A

Embora git add . seja amplamente utilizado, há uma diferença entre ele e git add -A:

• git add . adiciona apenas arquivos dentro do diretório atual e seus subdiretórios.
• git add -A adiciona todas as mudanças do repositório, independentemente do diretório em que o comando foi executado.

Se você estiver no diretório raiz do projeto, os dois comandos terão o mesmo efeito.

Quando usar git add . com cuidado?

O git add . pode ser perigoso se você tiver mudanças que não deseja incluir no próximo commit. Para evitar adicionar arquivos desnecessários, utilize:

git status

Esse comando exibe quais arquivos foram modificados antes de adicioná-los ao stage.

Caso tenha adicionado algo por engano, remova do stage com:

git reset arquivo.txt

Por que é importante entender o comando git add .?

O comando git add . pode parecer simples, mas é um dos comandos mais poderosos do Git. Ele permite que desenvolvedores adicionem todas as mudanças ao stage de uma só vez, facilitando o fluxo de trabalho. No entanto, é importante usá-lo com cautela, pois incluir arquivos desnecessários pode levar a problemas, especialmente em projetos grandes.

Uma boa prática ao utilizar esse comando é sempre verificar as mudanças antes de adicionar ao stage com git status. Dessa forma, você evita adicionar arquivos temporários, logs ou configurações locais que não deveriam estar no controle de versão. Além disso, configurar um arquivo .gitignore pode ajudar a evitar que arquivos irrelevantes sejam adicionados acidentalmente.

Algumas aplicações:

• Adicionar rapidamente todas as alterações ao stage
• Facilitar o versionamento de novos arquivos no repositório
• Preparar mudanças para um commit de maneira eficiente
• Evitar esquecer arquivos modificados ao fazer um commit
• Gerenciar versões de código de forma mais organizada

Dicas para quem está começando

• Sempre use 'git status' antes de 'git add .' para evitar adicionar arquivos desnecessários.
• Utilize um arquivo '.gitignore' para evitar que arquivos irrelevantes sejam adicionados ao repositório.
• Se adicionar um arquivo por engano, remova-o do stage com 'git reset arquivo.txt'.
• Para adicionar apenas arquivos específicos, prefira usar 'git add nome_do_arquivo'.
• Pratique o uso do 'git diff' para visualizar o que mudou antes de adicionar ao stage.

Contribuições de

Bruno Almeida

Especialista em Git e práticas de versionamento para equipes ágeis.

Mais sobre o autor

Compartilhe este tutorial