Renommer la branche Git locale et distante
- Renommer la branche locale Git actuellement active
- Renommer une branche Git non active
- Renommer une branche distante Git
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>