Como Verificar se um Branch Git Foi Excluído Localmente

Introdução

Neste laboratório, você aprenderá como verificar se um branch Git foi excluído localmente. Começaremos verificando a ausência de um branch específico usando git branch para garantir um estado inicial limpo. Em seguida, exploraremos o comando git reflog, uma ferramenta poderosa que registra atualizações para referências em seu repositório local, incluindo exclusões de branch, permitindo que você veja o histórico de alterações. Finalmente, testaremos esses métodos trabalhando com um branch recentemente excluído para confirmar como verificar efetivamente seu status de exclusão local.

Executar git branch para Verificar Ausência

Nesta etapa, verificaremos se um branch específico, que excluiremos posteriormente, não existe atualmente em nosso repositório Git. Esta é uma boa prática para garantir que estamos começando de um estado limpo antes de realizar operações como a exclusão de branch.

Primeiro, navegue até o diretório do seu projeto, caso você ainda não esteja lá. Lembre-se, nosso projeto está localizado em ~/project/my-time-machine.

cd ~/project/my-time-machine

Agora, vamos listar os branches existentes em nosso repositório usando o comando git branch. Por padrão, este comando mostra os branches locais.

git branch

Você deve ver uma saída semelhante a esta:

* master

Esta saída indica que, atualmente, apenas o branch master existe, e é o branch ativo (indicado pelo asterisco *).

Para o propósito deste laboratório, trabalharemos com um branch chamado feature/new-feature. Vamos confirmar que este branch não existe ainda executando git branch novamente. Como acabamos de executá-lo e vimos apenas master, já sabemos que ele não está lá, mas executar o comando novamente reforça o conceito de verificar o status do branch.

git branch

A saída ainda deve mostrar apenas o branch master:

* master

Isso confirma que o branch feature/new-feature não está presente em nosso repositório neste momento. Este é o estado que esperamos antes de prosseguirmos para criar e, em seguida, excluir este branch nas etapas subsequentes. Entender como verificar o status de seus branches é fundamental para gerenciar o histórico do seu projeto de forma eficaz.

Verificar git reflog para Exclusão

Nesta etapa, exploraremos o comando git reflog, que é uma ferramenta poderosa para recuperar commits ou branches perdidos. O reflog (log de referência) registra atualizações para os ponteiros dos branches e outras referências no repositório local. Isso significa que ele registra quase todas as alterações que você faz em seu repositório, incluindo commits, merges, rebases e até mesmo exclusões de branch.

Primeiro, certifique-se de estar no diretório do seu projeto:

cd ~/project/my-time-machine

Agora, vamos criar um novo branch que excluiremos posteriormente. Isso nos dará algo para procurar no reflog.

git branch feature/new-feature

Este comando cria um novo branch chamado feature/new-feature apontando para o commit atual. Vamos verificar se ele existe:

git branch

Você deve ver agora ambos os branches:

* master
  feature/new-feature

Agora, vamos excluir o branch feature/new-feature usando a flag -d, que é uma exclusão "segura" (ela impede a exclusão se o branch tiver alterações não mescladas).

git branch -d feature/new-feature

Você deve ver a saída confirmando a exclusão:

Deleted branch feature/new-feature (was <commit-id>).

Substitua <commit-id> pelo ID do commit real mostrado em seu terminal.

Agora, vamos verificar o reflog para ver se a exclusão foi registrada.

git reflog

A saída mostrará um histórico de ações. Você deve ver uma entrada relacionada à exclusão do branch, semelhante a esta (a saída exata pode variar):

<commit-id> HEAD@{0}: branch: deleted feature/new-feature
<commit-id> HEAD@{1}: branch: Created from <another-commit-id>
... (other reflog entries)

A entrada do reflog HEAD@{0}: branch: deleted feature/new-feature indica que o branch feature/new-feature foi excluído. O HEAD@{0} se refere à ação mais recente. Isso demonstra que, embora o branch tenha sumido do git branch, sua exclusão é registrada no reflog, tornando-o potencialmente recuperável.

Entender o git reflog é crucial porque ele atua como uma rede de segurança. Se você excluir acidentalmente um branch ou perder commits devido a um rebase ou outra operação, o reflog pode ajudá-lo a encontrar o ID do commit que você precisa para restaurar seu trabalho.

Testar com Branch Excluído Recentemente

Nesta etapa, demonstraremos como potencialmente recuperar um branch excluído recentemente usando as informações do git reflog. Embora não recuperemos totalmente o branch neste laboratório específico (já que ele não tinha commits exclusivos), praticaremos o comando usado para a recuperação.

Primeiro, certifique-se de estar no diretório do seu projeto:

cd ~/project/my-time-machine

Lembre-se da etapa anterior que excluímos o branch feature/new-feature. Vamos confirmar que ele ainda sumiu:

git branch

A saída ainda deve mostrar apenas o branch master:

* master

Agora, vamos olhar o reflog novamente para encontrar a entrada para o branch excluído.

git reflog

Encontre a linha que diz branch: deleted feature/new-feature. Observe o ID do commit associado a esta entrada. Ele se parecerá com algo como <commit-id> HEAD@{0}: branch: deleted feature/new-feature.

Para recuperar um branch excluído, você normalmente usaria o comando git branch <nome-do-branch> <commit-id>, onde <nome-do-branch> é o nome que você deseja dar ao branch recuperado, e <commit-id> é o ID do commit do reflog para onde o branch estava apontando por último.

Em nosso caso, o branch feature/new-feature foi criado e imediatamente excluído sem nenhum novo commit nele. Portanto, seu ID de commit no reflog será o mesmo que o ponteiro do branch master. Recuperá-lo essencialmente apenas recriaria o branch apontando para o mesmo commit que master.

Vamos simular o comando de recuperação usando o ID do commit que você encontrou no reflog para o branch excluído. Substitua <commit-id> pelo ID real da sua saída do reflog.

git branch recovered-feature <commit-id>

Este comando cria um novo branch chamado recovered-feature apontando para o ID do commit onde feature/new-feature estava antes da exclusão.

Agora, vamos verificar nossos branches novamente:

git branch

Você deve ver agora o branch recovered-feature listado:

* master
  recovered-feature

Isso demonstra como você pode usar o git reflog para encontrar o ID do commit de um branch perdido e, em seguida, usar git branch para recriá-lo. Esta é uma técnica poderosa para se recuperar de exclusões acidentais ou outras operações que alteram o histórico.

Resumo

Neste laboratório, aprendemos como verificar a ausência de um branch Git local usando o comando git branch. Confirmamos que, antes de criar e excluir um branch, é importante verificar o status atual do branch para garantir um ponto de partida limpo.

Também começamos a explorar o comando git reflog, entendendo seu papel no rastreamento de alterações nas referências no repositório local, incluindo exclusões de branch, o que é crucial para potencialmente recuperar trabalho perdido.