Renomear ramificação Git local e remota

Ashok Chapagai 30 janeiro 2023
  1. Renomear o Branch local do Git atualmente ativo
  2. Renomear um Branch Git não ativo
  3. Renomear um Git Remote Branch
Renomear ramificação Git local e remota

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>
    
Ashok Chapagai avatar Ashok Chapagai avatar

Ashok is an avid learner and senior software engineer with a keen interest in cyber security. He loves articulating his experience with words to wider audience.

LinkedIn GitHub

Artigo relacionado - Git Branch