Pular para o conteúdo principal

Git Rename Branch: Como renomear uma filial local ou remota

Saiba como renomear ramificações locais e remotas do Git usando o terminal ou a interface gráfica do usuário (GUI) de clientes populares como o GitHub.
Actualizado 8 de ago. de 2024

Um aspecto fundamental do Git é o uso de ramificaçõesque permitem que os desenvolvedores se desviem da linha principal de desenvolvimento e trabalhem em novos recursos ou correções em paralelo.

No entanto, o dinamismo dos projetos muitas vezes exige mudanças não apenas no código, mas também na forma como organizamos e nos referimos a essas ramificações. Há vários motivos pelos quais renomear uma ramificação do Git pode ser benéfico ou até mesmo necessário.

  1. Nome impreciso: O nome de uma filial pode não refletir com precisão sua finalidade ou conteúdo. Isso pode acontecer quando o escopo do trabalho evolui. Renomear a filial é importante para garantir que seu nome permaneça consistente com o trabalho que está sendo realizado.
  2. Melhor organização: À medida que os projetos se expandem, é importante manter uma convenção de nomenclatura clara e lógica para as ramificações. Renomear as ramificações pode ajudar a reorganizá-las e categorizá-las melhor, tornando o repositório mais fácil de navegar.
  3. Colaboração: Trabalhar em equipe significa garantir que todos possam entender rapidamente do que se trata cada ramo. Uma filial bem nomeada simplifica a comunicação e a colaboração, pois define expectativas claras sobre o conteúdo e a finalidade da filial.

Neste artigo, aprenderemos como renomear com segurança e facilidade o local e remotas locais e remotas.

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:

Renomear ramificações em clientes Git

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

Renomear ramificações em clientes Git

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

Renomear ramificações em clientes Git

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

Renomear ramificações em clientes Git

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.

Temas

Saiba mais sobre o Git!

curso

Introduction to Git

4 hr
38.8K
Familiarize yourself with Git for version control. Explore how to track, compare, modify, and revert files, as well as collaborate with colleagues using Git.
Ver DetalhesRight Arrow
Iniciar curso
Ver maisRight Arrow
Relacionado
Git

blog

O que é Git? Manual completo do Git

Saiba mais sobre o sistema de controle de versão mais conhecido e por que é uma ferramenta de colaboração indispensável para cientistas de dados e programadores.
Summer Worsley's photo

Summer Worsley

14 min

tutorial

Git Pull Force: Como substituir uma ramificação local por uma remota

Saiba por que o git pull --force não é a melhor maneira de substituir uma ramificação local pela versão remota e descubra o método adequado usando git fetch e git reset.
François Aubry's photo

François Aubry

tutorial

Tutorial de push e pull do GIT

Saiba como realizar solicitações Git PUSH e PULL por meio do GitHub Desktop e da linha de comando.

Olivia Smith

13 min

tutorial

Tutorial do GitHub e do Git para iniciantes

Um tutorial para iniciantes que demonstra como funciona o controle de versão do Git e por que ele é crucial para projetos de ciência de dados.
Abid Ali Awan's photo

Abid Ali Awan

17 min

tutorial

Git Prune: O que é o Git Pruning e como usar o Git Prune

O Git prune é um comando do Git que remove objetos do repositório que não são mais acessíveis a partir de qualquer commit ou branch, ajudando a liberar espaço em disco.
François Aubry's photo

François Aubry

5 min

tutorial

Como escrever um script Bash: um tutorial simples de scripts Bash

Descubra os fundamentos da criação de scripts Bash e aprenda a escrever um script Bash.
Kurtis Pykes 's photo

Kurtis Pykes

5 min

Ver maisVer mais