Como excluir uma ramificação git local e remota

As ramificações fazem parte do processo de desenvolvimento cotidiano e um dos recursos mais poderosos do Git. Uma vez que uma filial é mesclada, ela não serve para nada, exceto para pesquisas históricas. É prática comum e recomendada excluir a ramificação após uma mesclagem bem-sucedida.

Este guia aborda como excluir ramificações Git locais e remotas.

Excluir uma ramificação Git local

Para excluir uma ramificação local do Git, use o comando git branch com a opção -d ( --delete ):

git branch -d branch_name

Deleted branch branch_name (was 17d9aa0).

error: The branch 'branch_name' is not fully merged. If you are sure you want to delete it, run 'git branch -D branch_name'.

Como a mensagem acima diz, você pode forçar a exclusão usando a opção -D que é um atalho para --delete --force :

git branch -D branch_name

Observe que, se você excluir uma ramificação não imersa, perderá todas as alterações nessa ramificação.

Para listar todas as ramificações que contêm alterações não imersas, use o comando git branch --no-merged .

Se você tentar remover a ramificação atual, receberá a seguinte mensagem:

error: Cannot delete branch 'branch_name' checked out at '/path/to/repository'

Você não pode excluir o ramo em que está atualmente. Primeiro, alterne para outra ramificação e exclua o branch_name :

git checkout master git branch -d branch_name

Excluir uma ramificação remota do Git

No Git, ramificações locais e remotas são objetos separados. A exclusão de uma ramificação local não remove a ramificação remota.

Para excluir uma ramificação remota, use o comando git push com a opção -d ( --delete ):

git push remote_name --delete branch_name

Onde remote_name geralmente é origin :

git push origin --delete branch_name

… - branch_name

Há também um comando alternativo para excluir uma ramificação remota, ou seja, pelo menos para mim, mais difícil de lembrar:

git push origin remote_name:branch_name

error: unable to push to unqualified destination: branch_name The destination refspec neither matches an existing ref on the remote nor begins with refs/, and we are unable to guess a prefix based on the source ref. error: failed to push some refs to '[email protected]:/my_repo'

Em situações como essa, você precisará sincronizar sua lista de filiais com:

git fetch -p

A opção -p diz ao Git para remover quaisquer referências de rastreamento remoto que não existem mais no repositório remoto antes da busca.

Conclusão

Neste tutorial, você aprendeu como excluir ramificações Git locais e remotas. As ramificações são basicamente uma referência a um instantâneo de suas alterações e têm um ciclo de vida curto. Depois que a ramificação é mesclada no mestre (ou em outra ramificação principal), não é mais necessária e deve ser removida.

Com o comando git branch , você também pode renomear, criar e listar ramos Git locais e remotos.