Como renomear um branch do git

Neste artigo você vai aprender a como renomear um branch do git, de forma super simples e com apenas um comando

Para renomear um branch do git use o comando git branch -m. Se for o branch em que você está agora, não precisa citar o nome antigo: git branch -m novo-nome. Se for outro branch qualquer, informe os dois: git branch -m nome-antigo novo-nome. Para refletir a mudança no repositório remoto, envie o novo nome com git push origin -u novo-nome e apague o antigo no servidor com git push origin –delete nome-antigo.

Fala programador(a), beleza? Bora aprender mais sobre branches e também sobre versionamento com git!

Para renomear um branch no git é muito fácil!

Vamos utilizar o próprio comando git branch, com a flag -m

Veja como renomear um branch local:

Formação Recomendada

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

• 474 aulas
• 20 projetos
• 39h 27min

Conhecer formação

git branch -m <nomeatual> <novonome>

Basta trocar os nomes para os nomes dos seus branches

Para alterar o nome do branch atual, não precisamos citar o nome dele, veja:

git branch -m <novonome>

E assim o branch em que estamos terá seu nome alterado

Simples não é?

Quer aprender mais sobre git? Veja este curso gratuito:

Podemos também enviar o branch renomeado ao repositório com:

git push origin -u <novonome>

Assim qualquer outro colaborador conseguirá baixar este branch renomeado, para poder continuar seus trabalhos nele

Conclusão

Neste artigo você aprendeu a como renomear um branch do git

Utilizamos o comando: git branch -m

Note que para renomear o branch utilizado atualmente não precisamos colocar o nome dele, apenas o nome

Já se for algum branch que está no repositório, mas não em uso, vamos precisar colocar o nome antigo e novo

Confira nossos cursos gratuitos no Youtube, com vídeos todos os dias!

Se inscreva e ative o sininho para receber as notificações e aprender mais ainda sobre desenvolvimento web!

Veja também nosso catálogo de cursos na Udemy, todos com exercícios e projetos práticos, nas mais diversas tecnologias

O link acima contém um cupom de desconto para os cursos!

Cuidado com um detalhe: se já existir um branch com o nome novo que tu escolheu, o -m recusa a renomeação pra não sobrescrever nada por acidente

Se tu REALMENTE quer forçar e passar por cima do branch que já existe, aí usa o -M maiúsculo:

git branch -M <novonome>

Mas usa com consciência, porque ele sobrescreve o branch existente sem dó

E se o branch já estava no repositório remoto?

Aqui mora a pegadinha que pega muita gente

Renomear o branch local NÃO renomeia ele lá no servidor

Quando tu dá o push com o novo nome, o git cria um branch novo no remoto, mas o antigo continua lá do mesmo jeito

Então o fluxo completo fica assim:

Primeiro manda o branch com o novo nome e já define o upstream:

git push origin -u <novonome>

Depois apaga o branch antigo no servidor, porque o push não faz isso sozinho:

git push origin –delete <nomeantigo>

Agora sim o remoto tá com o nome certo e sem sobra do nome velho

E os colegas de time?

Quem já tinha o branch antigo baixado vai continuar enxergando a referência velha na máquina dele

Basta pedir pra rodarem:

git fetch –prune

Isso limpa as referências que não existem mais no remoto e sincroniza o nome novo pra todo mundo

Usar as perguntas e respostas do bloco geo.faq como uma seção de Perguntas frequentes, cada pergunta em H3 respondida logo abaixo

O tranco de verdade não é renomear o branch local, isso é um comando e acabou

É lembrar que o remoto não acompanha sozinho

Já vi muita gente renomear local, dar push e achar que resolveu, aí o branch com o nome velho continua lá no servidor bagunçando a lista pra todo o time

Por isso o combo que salva no dia a dia é: renomeia o local, dá push do nome novo com -u, apaga o nome antigo no remoto e avisa a galera pra rodar um git fetch –prune

Faz esses quatro passos e ninguém fica com referência fantasma na máquina