Comment renommer une branche Git locale ?

16 October 2025 - 4 mins read time
Tags: Git

Comment renommer une branche Git locale ?

Tu as créé une branche avec un nom qui ne te convient plus ?
Pas de panique 😎 ! Git te permet de renommer une branche locale très facilement, que tu sois sur cette branche ou non.
Dans cet article, tu apprendras toutes les méthodes pratiques pour renommer une branche Git locale (et distante), étape par étape.

🧠 Pourquoi renommer une branche ?

Les noms de branches sont essentiels pour garder un workflow clair et professionnel.
Mais il arrive souvent de vouloir les renommer :

• après une faute de frappe (feature/fixx-bug → feature/fix-bug) ;
• pour unifier une convention (dev → develop) ;
• pour mieux refléter le contenu de la branche (feature/login → feature/authentication).

Heureusement, Git rend cette opération simple et sans perte de données.

1. Vérifier sur quelle branche tu te trouves

Avant toute modification, vérifie ta branche actuelle :

git branch

Le résultat ressemble à ceci :

* feature/login
  main
  develop

L’étoile * indique la branche active.

2. Renommer la branche actuelle

Si tu veux renommer la branche sur laquelle tu es actuellement, utilise :

git branch -m nouveau-nom

Exemple :

git branch -m feature/login feature/authentication

ou, si tu es déjà sur feature/login :

git branch -m feature/authentication

✅ Résultat :

• La branche locale est renommée immédiatement.
• Aucun commit n’est perdu.
• Ton historique reste intact.

3. Renommer une autre branche (non active)

Si tu veux renommer une branche sur laquelle tu n’es pas, spécifie les deux noms :

git branch -m ancien-nom nouveau-nom

Exemple :

git branch -m dev develop

👉 Cela renomme la branche dev en develop, même si tu es actuellement sur main.

4. Mettre à jour la branche distante (optionnel)

Renommer une branche locale ne change pas automatiquement son nom sur le dépôt distant (origin). Pour aligner les deux, voici les étapes à suivre :

🧾 Étape 1 : Supprimer l’ancienne branche distante

git push origin --delete ancien-nom

🧾 Étape 2 : Pousser la nouvelle branche

git push origin nouveau-nom

🧾 Étape 3 : Changer la branche de suivi (tracking)

Si la branche locale suivait l’ancienne distante, il faut l’associer à la nouvelle :

git push --set-upstream origin nouveau-nom

💡 Astuce : cette commande est souvent abrégée avec -u :

git push -u origin nouveau-nom

5. Vérifier la configuration du suivi

Pour t’assurer que ta nouvelle branche est bien liée à la bonne branche distante :

git branch -vv

Tu verras un affichage du type :

* feature/authentication  9d8a3e1 [origin/feature/authentication] Add login service

Si la mention [origin/...] correspond à ton nouveau nom, tout est parfait ✅.

6. Cas particulier : dépôt collaboratif

⚠️ Si tu travailles sur un dépôt partagé, préviens ton équipe avant de renommer une branche distante. Les autres collaborateurs devront :

git fetch origin
git branch -m ancien-nom nouveau-nom
git branch -u origin/nouveau-nom nouveau-nom

Ou, plus simplement, supprimer et re-cloner leur branche locale si nécessaire.

🧩 En résumé

🚀 Conclusion

Renommer une branche Git locale est une opération rapide, sûre et réversible. Elle ne modifie pas ton historique ni tes commits, seulement le nom de la référence.

💡 Bon réflexe : adopte une convention claire pour nommer tes branches dès le début (feature/, fix/, release/), mais n’hésite pas à les renommer quand c’est nécessaire — Git te le permet sans risque !