Renommer la branche Git locale et distante

Ashok Chapagai 25 décembre 2021
  1. Renommer la branche locale Git actuellement active
  2. Renommer une branche Git non active
  3. Renommer une branche distante Git
Renommer la branche Git locale et distante

Lorsque vous travaillez sur un projet, si vous pensez que le nom de la branche ne convient pas à la branche sur laquelle vous travaillez et que vous souhaitez renommer la branche, il existe plusieurs façons de renommer la branche en fonction des différents scénarios sur lesquels vous vous trouvez. . Dans cet article, nous examinons comment renommer la branche sur une machine locale ou si la branche se trouve dans le référentiel distant.

Renommer la branche locale Git actuellement active

La syntaxe pour renommer la branche actuellement active est ci-dessous.

git branch -m <New_Branch_Name>

Par exemple, si nous travaillons actuellement sur le nom de la branche bug-fix et devons changer le nom en bug-fix-1, nous pouvons utiliser la syntaxe suivante pour renommer la branche.

git branch -m bug-fix-1

Remarque : L’indicateur -m est la forme abrégée de --move, qui agit de la même manière que la commande mv.

Cependant, avec cette méthode, si nous transmettons les modifications au référentiel distant, une nouvelle branche avec les modifications sera créée et l’ancienne restera telle quelle.

Renommer une branche Git non active

Si nous travaillons dans une branche master et devons renommer une autre branche nommée bug-fix en bug-fix-1 , nous pouvons suivre la syntaxe suivante.

git branch -m <Old_Branch_Name> <New_Branch_Name>

Par exemple,

git branch -m bug-fix bug-fix-1

Remarque : avec git, nous pouvons également définir un alias pour utiliser facilement les commandes git comme ci-dessous.

git config --global alias.rename 'branch -m'

Maintenant, avec l’alias défini, nous pouvons utiliser la syntaxe suivante pour renommer la branche git.

git rename <New_Name> # If Renaming Currently Active Branch

Ou,

git rename <Old_Name> <New_Name> # If Renaming a Not Active Branch

Renommer une branche distante Git

Si nous voulons renommer une branche distante, nous devons plutôt suivre trois étapes.

  • Renommez le nom de la branche localement.
    git branch -m <New_Branch_Name>
    # OR
    git branch -m <Old_Branch_Name> <New_Branch_Name>
    
  • Transférez les changements de nom de branche vers le référentiel distant.
    git push origin :<Old_Branch_Name> <New_Branch_Name>
    

    Remarque : Les deux points (:), devant <Old_Branch_Name>, ne doivent pas être manqués.

  • Définir la branche locale pour suivre le référentiel distant du même nom, pour cela, nous devons utiliser la syntaxe suivante.
    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

Article connexe - Git Branch