Git Rename Branch: Como renomear uma filial local ou remota

Renomear uma filial local

Renomear uma ramificação local é uma maneira simples e eficaz de manter o projeto organizado e garantir que os nomes das ramificações reflitam com precisão seu conteúdo ou finalidade.

Renomear uma ramificação local não a renomeia no repositório remoto. Se a filial for programada remotamente, você precisará tratá-la separadamente.

Pré-requisitos

Antes de começarmos, precisamos nos certificar de que o Git está instalado e que estamos no diretório do repositório em nosso computador local.

• Verifique a instalação: Certifique-se de que você tenha o Git instalado localmente. Você pode verificar isso executando git --version no terminal ou no prompt de comando. Se ele não estiver instalado, leia este tutorial sobre como instalar o Git ou visite o site oficial do Git para obter instruções de download e instalação.
• Navegue até o diretório do repositório: Para começar, precisamos abrir um terminal ou prompt de comando e navegar até o diretório do projeto Git para o qual desejamos renomear um branch.

Verificando a filial

Antes de fazermos qualquer coisa no ramo, primeiro precisamos mudar para esse ramo usando o comando:

git checkout <current_branch_name>

Substitua pelo nome atual da filial.

Renomear a filial

Depois que o ramo é verificado, renomeamos o ramo usando:

git branch -m <new_branch_name>

Substitua pelo novo nome do ramo.

Verificação

Podemos verificar se o nome foi alterado listando todas as ramificações com o comando git branch. O ramo atual terá um asterisco (*) próximo a ele.

Renomear uma filial remota

Renomear uma ramificação remota no Git é uma tarefa que envolve algumas etapas adicionais para garantir que as alterações sejam refletidas no repositório remoto.

Impulsionar mudanças locais

Antes de renomear um ramo remoto, devemos nos certificar de que o ramo local não contenha trabalho que ainda não esteja no ramo remoto. Isso evita que essas alterações sejam perdidas durante o processo de renomeação. Se você não tiver certeza de como fazer push de alterações, confira este Tutorial de push e pull do Git.

Renomear a filial local

Antes de renomear a ramificação remota, primeiro precisamos renomear a ramificação localmente, como aprendemos acima.

Empurrando o novo ramo

Depois de renomear o ramo localmente, podemos enviar esse novo ramo para o repositório remoto usando:

git push origin -u <new_branch_name>

A opção -u define o ramo enviado como o upstream para o ramo local. Isso faz com que os futuros pushes e pulls desse branch façam referência automática ao remote com o novo nome.

Excluindo o ramo antigo

Esse processo não renomeia um branch remote, mas cria uma nova cópia dele com um novo nome. Portanto, depois de fazer isso, é recomendável que você limpe o repositório excluindo a ramificação antiga usando o seguinte comando:

git push origin --delete <old_branch_name>

Considerações importantes

Ao renomear uma ramificação remota no Git, vários aspectos críticos exigem nossa atenção para garantir que o processo seja tranquilo e não interrompa o fluxo de trabalho de nenhum colaborador do projeto.

Devemos sempre informar os outros membros da nossa equipe sobre a renomeação do ramo. Essa comunicação evita confusão, pois você pode encontrar erros ao tentar fazer pull ou push para um branch que não existe mais com seu nome original.

Os colaboradores devem renomear suas cópias locais do ramo usando o comando git branch -m . Além disso, eles precisarão redefinir a ramificação upstream com git push origin -u para garantir que os futuros envios sejam feitos para a ramificação correta.

Se houver alguma pull request aberta direcionada ao nome do branch antigo no repositório remoto, você precisará de nossa atenção. Talvez seja necessário fechá-los e criar novos que visem o ramo recém-nomeado.

Renomear ramificações em clientes Git

A maioria dos clientes Git (por exemplo, o GitHubGitKraken, Sourcetree, GitLab, etc.) oferecem opções para renomear ramificações por meio de suas interfaces gráficas de usuário.

Para renomear um branch no GitHub, começamos navegando até o repositório. Em seguida, clicamos nomenu suspenso branch:

Na parte inferior do menu, clique em Exibir todas as ramificações:

Em seguida, precisamos localizar a ramificação que desejamos renomear e clicar no menu suspenso de três pontos à direita:

Por fim, clicamos na opção Renomear opção de filial e renomeamos a ramificação:

Conclusão

A renomeação de ramificações no Git desempenha um papel crucial na manutenção de uma estrutura de projeto eficiente e intuitiva. 

É essencial distinguir entre renomear um ramo localmente e remotamente, pois cada um tem seu próprio conjunto de etapas e implicações no fluxo de trabalho.

Mais importante ainda, a comunicação com a equipe é fundamental. Manter todos informados garante uma transição perfeita e evita possíveis interrupções no ciclo de desenvolvimento.

Se você quiser saber mais sobre o Git, recomendo este curso introdutório ao Git.