Git : renommer la branche

Lorsque vous travaillez avec Git, il est courant que les projets contiennent plusieurs branches. Parfois, ces branches changent d’objectif au fil du temps ou ont simplement une erreur de nom, et dans ce cas, il est nécessaire de renommer la branche.

Dans ce guide, nous allons vous montrer les instructions étape par étape pour renommer les branches Git via la ligne de commande sur un système Linux. Nous allons vous montrer le processus de renommage des branches locales ainsi que des branches distantes et passer en revue ce que vous devez savoir pour assurer une transition en douceur.

Dans ce tutoriel, vous allez apprendre :

• Comment renommer des branches Git locales et distantes

Renommer la branche Git

Renommer la branche Git

Lorsque vous renommez une branche Git, vous avez quelques options à prendre en compte. Il est fort probable que vous souhaitiez renommer la branche locale et la branche distante avec elle. Mais il est également possible de renommer uniquement la branche locale. Nous vous montrerons ci-dessous les étapes à suivre pour les deux options.

Si le HEAD pointe actuellement vers la branche que vous souhaitez renommer – en d’autres termes, si vous avez « extrait » la branche actuelle ou si vous travaillez activement avec elle – vous pouvez la renommer avec la commande suivante.

git branch -m <new_name>

Ou pour renommer une autre branche vers laquelle le HEAD n’est pas pointé :

git branch -m <old_name> <new_name>

Cela a renommé la branche Git locale. Si vous poussez cette branche, elle n’entrera plus en conflit avec l’ancien nom, mais sera plutôt sa propre branche sous le nouveau nom. À partir de là, c’est à vous de décider si vous souhaitez supprimer l’ancienne branche.

git push <remote> --delete <old_name>

Enfin, poussez la nouvelle branche à distance et réinitialisez la branche en amont.

git push <remote> <new_name>
git push <remote> -u <new_name>

Notez que certains serveurs peuvent nécessiter l’option --unset-upstream afin de commencer à pousser le nouveau nom au lieu de l’ancien.

git checkout <new_name>
git branch --unset-upstream

Conclusion

Dans cet article, nous avons appris à renommer une branche Git locale et distante sous Linux. Nous avons également vu quelques commandes recommandées pour aider à finaliser les changements et assurer une transition en douceur.