Renomear ramificação Git local e remota
- Renomear o Branch local do Git atualmente ativo
- Renomear um Branch Git não ativo
- Renomear um Git Remote Branch
Ao trabalhar em um projeto, se você sentir que o nome do branch não é adequado para o branch em que está trabalhando e deseja renomear o branch, existem algumas maneiras de renomear o branch, dependendo dos diferentes cenários em que você está . Neste artigo, veremos como renomear o branch em uma máquina local ou se o branch está no repositório remoto.
Renomear o Branch local do Git atualmente ativo
A sintaxe para renomear o branch atualmente ativo está abaixo.
git branch -m <New_Branch_Name>
Por exemplo, se estamos trabalhando no nome do branch bug-fix
e precisamos mudar o nome para bug-fix-1
, podemos usar a seguinte sintaxe para renomear o branch.
git branch -m bug-fix-1
Nota: O sinalizador -m
é a forma abreviada de --move
, que atua de forma semelhante ao comando mv
.
No entanto, com este método, se enviarmos as alterações para o repositório remoto, um novo branch com as alterações será criado e o antigo permanecerá como está.
Renomear um Branch Git não ativo
Se estivermos trabalhando em um branch master
e precisarmos renomear outro branch chamado bug-fix
para bug-fix-1
, podemos seguir a seguinte sintaxe.
git branch -m <Old_Branch_Name> <New_Branch_Name>
Por exemplo,
git branch -m bug-fix bug-fix-1
Nota: Com o git, também podemos definir um alias para usar os comandos git facilmente, conforme mostrado a seguir.
git config --global alias.rename 'branch -m'
Agora, com o alias definido, podemos usar a seguinte sintaxe para renomear o branch git.
git rename <New_Name> # If Renaming Currently Active Branch
Ou,
git rename <Old_Name> <New_Name> # If Renaming a Not Active Branch
Renomear um Git Remote Branch
Se quisermos renomear um branch remoto, precisamos seguir três etapas.
-
Renomeie o nome de ramificação localmente.
git branch -m <New_Branch_Name> # OR git branch -m <Old_Branch_Name> <New_Branch_Name>
-
Envie as alterações no nome do branch para o repositório remoto.
git push origin :<Old_Branch_Name> <New_Branch_Name>
Nota: Os dois pontos (
:
), antes de<Old_Branch_Name>
, não devem ser perdidos. -
Definir branch local para rastrear o repositório remoto com o mesmo nome, para isso, precisamos usar a seguinte sintaxe.
git push --set-upstream origin <New_Branch_Name>