Comando Git Status Explicado com Exemplos

Git é um sistema de controle de versão que ajuda você a rastrear mudanças em seu código e colaborar facilmente com outros. O Git oferece diferentes comandos para realizar diferentes tarefas. Um comando importante é git status, que mostra o estado atual de seus arquivos, incluindo mudanças que estão preparadas, não preparadas ou não rastreadas. Neste artigo, discutiremos como usar o comando git status para gerenciar seu fluxo de trabalho git de forma eficiente.
Relacionado: se você é novo no Git, confira nosso guia para iniciantes sobre Git.
O que é git status
O comando git status recupera o estado atual do seu projeto. Ele fornece uma lista de arquivos que estão preparados para serem confirmados, arquivos com modificações que não foram preparados e arquivos recém-criados que o Git não está rastreando. Além disso, ajuda você a ver o que está acontecendo em seu diretório de trabalho e quais ações você pode precisar tomar a seguir.
Importância de Usar o Comando Git Status
Aqui estão algumas vantagens que mostram a importância de usar o comando git status:
- Ele exibe os arquivos que foram alterados, preparados ou que não estão sendo rastreados.
- Ele recupera uma visão geral do status atual do projeto.
- Ajuda a entender quais mudanças estão prontas para serem confirmadas.
- O comando git status ajuda a evitar a confirmação acidental de arquivos indesejados.
- Mantém seu fluxo de trabalho limpo e organizado.
- Lembra você de incluir ou excluir arquivos da área de preparação.
- É útil para solucionar conflitos de mesclagem.
Quando Usar git status
Execute o comando git status sempre que quiser inspecionar o estado atual do seu diretório de trabalho e da área de preparação. Os desenvolvedores costumam usar esse comando após fazer alterações em arquivos. Além disso, permite identificar os arquivos que foram alterados, aqueles preparados para confirmação e aqueles que permanecem não rastreados. Executar o comando git status antes de confirmar garante que incluímos todas as mudanças pretendidas e evitamos confirmar acidentalmente arquivos indesejados.
Além disso, o comando git status pode ser usado antes de mudar de branches ou puxar novas mudanças, pois mostra se seu diretório de trabalho está limpo ou tem atualizações pendentes.
Como Usar o Comando Git Status
Você pode executar o comando git status para verificar o estado atual de qualquer repositório git:
git statusA saída indica que não há modificações ou arquivos não rastreados no repositório. Isso significa que nossa árvore de trabalho está limpa.

Vamos criar um novo arquivo vazio em nosso repositório git:
touch new_file.txt
Após criar o arquivo, confirme o status do seu repositório Git usando:
git statusA saída mostra Arquivos não rastreados: new_file.txt. Isso significa que o arquivo chamado “new_file.txt” existe no repositório, mas o Git ainda não está rastreando:

Aplique o comando git add para mover arquivos não rastreados para a área de preparação:
git add new_file.txt
Em seguida, use o comando git status para monitorar o estado atual do seu repositório. A saída agora exibe mudanças pendentes para confirmação: um arquivo recém-adicionado chamado new_file.txt. Isso indica que o “new_file.txt” foi preparado com sucesso e está pronto para ser confirmado:

Para salvar as modificações preparadas, execute o comando abaixo:
git commit -m "Meu primeiro commit"
Substitua “Meu primeiro commit” por qualquer mensagem personalizada de sua escolha. Após isso, verifique o status atual com git status
A mensagem “nada para confirmar, árvore de trabalho limpa” confirma que o arquivo foi adicionado com sucesso ao repositório:

Abra “new_file.txt” em um editor de texto, faça algumas alterações:

Em seguida, execute o comando git status para verificar o status do arquivo quando ele é editado. Desta vez, mostra Mudanças não preparadas para confirmação: modificado: new_file.txt. Isso indica que o arquivo foi atualizado, mas ainda não foi adicionado à área de preparação:

Adicione o arquivo atualizado à área de preparação executando o seguinte comando:
git add new_file.txtEm seguida, aplique as mudanças executando o comando abaixo:
git commit -m "o arquivo foi modificado"
Depois, verifique o status atual do git:
git statusA saída indica que a árvore de trabalho foi limpa:

Vamos remover um arquivo executando o comando rm:
git rm new_file.txt
Na saída, o git retorna a mensagem Mudanças a serem confirmadas: deletado: new_file.txt:

Após isso, você pode usar o seguinte comando para registrar permanentemente a deleção do arquivo no histórico de commits do repositório:
git commit -m "o arquivo foi deletado"
Finalmente, verifique o status executando o comando abaixo:
git status
Opções Úteis do git status
Você pode usar diferentes opções com o comando git status para alterar a forma como a saída é exibida. Por exemplo:
- Podemos usar
git status --shortpara obter um resumo conciso. - O
git status -unos permite controlar como os arquivos não rastreados aparecem. git status -u=normalexibe arquivos não rastreados da maneira usual.git status -u=allmostra cada arquivo individual dentro de diretórios não rastreados.- Se você preferir uma visualização mais limpa sem arquivos não rastreados, pode usar
git status -u=no. - A opção
git status --porcelainfornece saída em um formato legível por máquina, que é especialmente útil para scripts e tarefas de automação.
Considerações Finais
O comando git status fornece uma visão clara e detalhada do diretório de trabalho atual e da área de preparação. Ajuda você a entender quais arquivos estão modificados, preparados, não rastreados ou prontos para serem confirmados. Usando este comando, você pode manter seu fluxo de trabalho organizado, evitar confirmar mudanças indesejadas e garantir que você esteja sempre familiarizado com o estado atual do seu projeto.
Além do git status, você também deve aprender sobre o comando git cache para gerenciar o cache em sua pasta git.