Changer le nom d'une branche locale

Original article: Git Rename Branch – How to Change a Local Branch Name

Au cours d'un projet, on peut vouloir renommer une branche locale, nous allons voir comment le faire avec Git dans cet article. Il existe en fait deux méthodes.

Renommer une branche avec Git, première méthode

1 : Se placer dans le dossier racine du projet

Il faut avant toute chose se trouver dans un terminal à la racine du projet. Pour cela, on utilise la commande cd (pour change directory).

Pour un projet dont le dossier se trouve directement sur le bureau, par exemple, on utiliserait cette commande-là :

cd Bureau/Mon_Projet

Dans mon cas, le projet s'appelle Happy_Messages_Bot :

2 : Passer sur la branche à renommer

Pour ce faire, on utilise la commande git checkout :

git checkout ma-branche

Dans mon cas, je passe sur une branche appelée test-branch que j'ai créée au préalable :

3 : Utiliser l'outil de gestion des branches avec l'option -m

Enfin voici la commande pour renommer une branche dans sa forme canonique :

git branch -m nouveau-nom-de-branche

Dans mon cas, je veux renommer ma branche de test-branch à test-branch2 :

git branch -m test-branch2

Pour vérifier que la branche a bien été renommée, on peut utiliser git status, ce qui pour moi donne :

Renommer une branche avec Git, deuxième méthode

Il n'est en fait pas nécessaire de passer sur la branche locale en question pour la renommer !

2 : Passer sur une autre branche, comme master ou main

Après la même première étape que précédemment, on s'assure de ne pas être sur la branche à renommer en utilisant git status :

Pour passer sur la branche principale (master ou main selon le projet), on utilise git checkout master ou git checkout main :

3 : Utiliser l'outil de gestion des branches avec l'option -m

Sans être dessus, en précisant la branche à renommer, on n'a maintenant plus besoin que d'une seule commande :

git branch -m ma-branche nouveau-nom-de-branche

Donc dans mon cas, pour arriver au même résultat qu'avec la première méthode :

git branch -m test-branch test-branch2

Pour vérifier que l'action s'est bien produite, je vais cette fois-ci faire la liste des branches avec git branch :

Voilà les deux méthodes pour renommer une branche locale avec Git.