Renommer une branche avec Git

On fait tou·te·s des erreurs, il arrive parfois même qu’on nous demande un nom spécifique dans un projet quand on a déjà choisi le nom d’une branche avec Git (git checkout -b new_branch).

Pour renommer une branche, il existe plusieurs uses cases: Une branche locale, non poussée:

Dans ce cas, on a déjà fait une nouvelle branche mais le nom n’est finalement pas convenable. On a déjà fait des modifications, pourquoi pas des commits mais pas encore de push.

# mise en contexte
git checkout -b name
git branch -D new_name

Le nouveau nom de la branche est new_name, les précédents dans la branche sont adaptés. Renommer une branche distante

Ici, on a déjà fait des modifications, on a commit et pusher. On veut renommer la branche. Techniquement, ce n’est pas réellement possible avec Git, il faut supprimer la branche distante et repusher les modifications de la branche courante. Ce que tu vois dans ton outil graphique (que ça soit GitKraken ou ton IDE) ne reflète pas la réalité, voilà ce qu’il fait en arrière plan :

git push origin --delete current_name # on supprime la branche 
git branch -m new_name # on renomme la branche courante
git push -u origin new_name # on push les modifications dans origin new_name

Et c’est tout. 🙂