Git Excluir ramificação: Como remover ramificações locais e remotas

Exclusão de uma ramificação local do Git

Excluir uma ramificação local não é difícil; felizmente, é uma das tarefas mais simples do Git. Vamos analisar a maneira mais segura de fazer isso e os cuidados que você deve ter.

O comando básico para excluir uma filial local

A maneira mais segura de excluir uma ramificação local é com o sinalizador -d:

git branch -d <branch_name>

Lembre-se de que esse comando só funciona se o ramo tiver sido totalmente mesclado ao ramo atual (normalmente main ou master). Se houver alguma alteração não mesclada, o Git interromperá você para evitar a perda acidental de dados.

Forçar a exclusão de uma filial local

Se você tentar excluir um ramo que ainda tenha alterações não mescladas, o Git não permitirá, a menos que você force:

git branch -D <branch_name>

O sinalizador -D (observe as letras maiúsculas) ignora a verificação de segurança e exclui a ramificação imediatamente, independentemente de ela ter sido mesclada ou não. Eu aconselharia você a ter cuidado com isso. Qualquer trabalho não mesclado será perdido, a menos que você tenha um backup ou outra ramificação apontando para os mesmos commits.

Verificação de alterações não mescladas antes da exclusão

Antes de você chegar ao ponto de excluir uma ramificação, é uma boa ideia verificar se ela tem alterações não mescladas. Você pode fazer isso com:

git branch --no-merged

O comando acima lista todas as ramificações que não foram mescladas com a ramificação atual. Se o que você está prestes a excluir aparecer nessa lista, verifique se não precisa de nenhuma das alterações antes de continuar.

Você quer uma referência rápida para os comandos do Git, incluindo a exclusão de ramificações? Faça o download do sitee da prática Git Cheat Sheet.

Exclusão de uma ramificação remota do Git

A exclusão de um ramo remoto é um pouco diferente da exclusão de um ramo local. Como as ramificações remotas existem em repositórios compartilhados, removê-las ajuda a manter as coisas organizadas e evita que ramificações desatualizadas atrapalhem os fluxos de trabalho da equipe.

O comando básico para excluir uma ramificação remota

Para excluir um branch de um repositório remoto como GitHub, GitLab ou Bitbucket, use:

git push origin --delete <branch_name>

Esse comando remove a referência do branch do repositório remoto, tornando-o inacessível para outros. No entanto, as cópias locais da ramificação em outros computadores não serão afetadas e precisarão ser limpas separadamente.

Verificação da exclusão de ramificação remota

Depois de excluir uma ramificação remota, você precisará confirmar que ela realmente desapareceu. Primeiro, busque as atualizações mais recentes no repositório remoto:

git fetch --prune

Com isso, você remove referências desatualizadas de rastreamento remoto. Para verificar novamente se o ramo não está mais listado, execute o seguinte:

git branch -r

O comando acima exibe todas as filiais remotas restantes. Se o ramo excluído ainda aparecer, tente executar outro git fetch --prune ou verifique se o comando de exclusão foi executado no controle remoto correto.

Práticas recomendadas para excluir ramificações do Git

A exclusão de ramificações é uma parte rotineira do trabalho com o Git, mas fazer isso da maneira correta pode evitar que você tenha dores de cabeça desnecessárias. Aqui estão algumas práticas recomendadas para manter seu repositório organizado e evitar possíveis erros.

Evitar a exclusão prematura de ramificações não mescladas

Antes de excluir uma ramificação, certifique-se de que ela não contenha nenhum trabalho não mesclado que ainda seja necessário. Se você não tiver certeza, verifique seu status com:

git branch --no-merged

Se a ramificação tiver alterações importantes que não foram mescladas, considere mesclá-las ou arquivá-las primeiro em vez de excluí-las completamente.

Excluir após a mesclagem

Uma vez que um recurso ou correção tenha sido mesclado à ramificação principal (main ou master), não há motivo para manter a ramificação antiga. A exclusão de ramificações mescladas ajuda a evitar a desordem e facilita a visualização de quais ramificações ainda estão ativas.

Comunique-se com sua equipe

Como cortesia profissional, quando você estiver trabalhando em um projeto colaborativo, evite excluir uma ramificação sem avisar a sua equipe. Isso pode causar confusão - ou pior, atrapalhar o trabalho de outra pessoa. Antes de remover uma ramificação remota, verifique com sua equipe se ninguém ainda a está usando. Prefiro uma simples mensagem ou nota no Slack para evitar frustrações.

Antes de excluir uma ramificação, você pode querer organizar seu histórico de commits eliminando-os. Saiba como em nosso tutorial Git Squash Commits.

Problemas comuns ao excluir ramificações do Git

A exclusão de ramificações no Git geralmente não apresenta problemas, mas há algumas armadilhas comuns que podem atrapalhar você. Veja a seguir o que você deve observar e como lidar com esses problemas caso eles surjam.

Exclusão de uma ramificação que não foi totalmente mesclada

Novamente, se você tentar excluir um ramo que ainda tenha alterações não mescladas usando git branch -d, o Git o interromperá para evitar uma possível perda de dados. Isso é uma segurança contra falhas. Qualquer trabalho não mesclado será perdido se você forçar a exclusão com -D.

Se você já tiver excluído um ramo e perceber que precisa dele de volta, poderá recuperá-lo usando o reflog do Git:

git reflog
git checkout -b <branch_name> <commit_hash>

Isso permite que você restaure o ramo a partir do último commit conhecido, se ele não tiver sido completamente perdido para a coleta de lixo.

Excluindo o ramo atual

O Git não permitirá que você exclua o ramo em que está atualmente, o que faz sentido, caso contrário, você ficaria sem um ramo ativo. Se você vir um erro ao tentar excluir um ramo, mude para outro ramo primeiro:

git checkout main

Ou, se você estiver usando o Git 2.23+:

git switch main

Quando estiver em um ramo diferente, você poderá excluir com segurança o ramo que pretendia remover.

Você precisa alternar entre as ramificações antes de excluir uma? Nosso guia sobre como fazer check-out de uma ramificação remota no Git orienta você durante o processo.

Exclusão acidental de uma ramificação remota

Se uma ramificação remota tiver sido excluída por engano, você poderá restaurá-la (supondo que ainda tenha uma cópia local) fazendo push de volta para a remota:

git push origin <deleted_branch_name>

Isso recria o branch no repositório remoto, restaurando o acesso dos colaboradores. Se não houver uma cópia local, talvez você precise verificar manualmente o histórico de commits e recriar o ramo.

Por que não consigo excluir uma ramificação do Git?

Se você estiver tendo problemas para excluir uma ramificação no Git, reveja os problemas comuns; verifique se ela foi totalmente mesclada, se você está na ramificação no momento ou se é uma ramificação remota. A partir daí, pode ser que você tenha configurações ou permissões.  

1. A primeira coisa a verificar é se você está atualmente nessa filial. O Git não permitirá que você exclua um ramo no qual esteja trabalhando ativamente, portanto, você precisará mudar para um ramo diferente primeiro. 
2. Se esse não for o problema, é possível que a ramificação ainda tenha alterações não mescladas. O Git protege as ramificações com trabalho não mesclado, portanto, a menos que você tenha certeza absoluta de que não precisa dessas alterações, será necessário mesclar ou forçar a exclusão da ramificação usando git branch -D branch-name.
3. Se você estiver tentando excluir uma ramificação remota, um simples git branch -d não resolverá o problema. Em vez disso, você precisará executar git push origin --delete branch-name e, para limpar as referências antigas, poderá usar git fetch --prune. 
4. Alguns repositórios, especialmente aqueles hospedados em plataformas como GitHub ou GitLab, têm ramificações protegidas que não podem ser excluídas sem que você altere as configurações. Se estiver trabalhando em um repositório compartilhado, você também poderá precisar das permissões corretas para excluir branches.

Você ainda está preso? A execução do site git branch -v pode fornecer mais detalhes sobre o status do ramo e ajudar você a descobrir o que está acontecendo antes de tentar novamente.

Automatizando a limpeza de ramificações com o Git

Eu adoro uma boa automação. Embora a exclusão manual de ramificações funcione bem e você deva saber como fazê-la, há outra maneira. Se você estiver lidando com muitas ramificações (como em uma configuração de equipe), a automação pode economizar tempo e manter as coisas mais organizadas. O Git oferece algumas maneiras de simplificar a limpeza de ramificações, reduzindo a desordem sem esforço extra.

Automatize a limpeza de filiais remotas

Quando uma ramificação remota é excluída, seu Git local ainda mantém uma referência a ela até que você atualize as coisas manualmente. Em vez de limpá-los um a um, você pode usar:

git fetch --prune

O comando acima remove automaticamente as referências locais a ramificações que não existem mais no repositório remoto, mantendo tudo em sincronia. Ao executar isso regularmente, você evita que ramificações desatualizadas se acumulem em seu repositório local.

Use os ganchos do Git para limpeza

Para equipes ou projetos maiores, os ganchos do Git podem ajudar a automatizar a limpeza de ramificações. Hooks são scripts personalizados que são executados em determinados pontos do fluxo de trabalho do Git, como depois de mesclar uma ramificação. Você pode configurar um gancho pós-fusão para excluir automaticamente as ramificações mescladas após um período definido, garantindo que as ramificações antigas não permaneçam desnecessariamente.

Conclusão

As ramificações podem ficar bagunçadas com o tempo, mas um pouco de "corte" ajuda a manter o repositório limpo e o fluxo de trabalho eficiente. Ao criar o hábito de excluir ramificações mescladas, verificar novamente as não mescladas e manter a comunicação aberta em projetos de equipe, você pode evitar esses problemas. E se você quiser ir além, ferramentas de automação como git fetch --prune e Git hooks podem ajudar a manter seu repositório limpo sem esforço extra.

A exclusão de ramificações é apenas uma etapa para você dominar o Git. Para aprofundar seu conhecimento sobre controle de versão, confira o curso Intermediate Git. Se você estiver trabalhando com repositórios do GitHub, é essencial ter uma sólida compreensão dos principais conceitos do GitHub. Saiba mais no curso Introdução aos conceitos do GitHub!