Gestion des branches Git

Les branches s’accumulent vite dans un projet actif. Sans convention de nommage ni nettoyage régulier, le dépôt devient illisible. Ce guide donne les commandes pour inspecter vos branches, une convention de nommage éprouvée, et un workflow de nettoyage.

Prérequis : Les branches Git en bref et Merge et résolution de conflits.

Ce que vous allez apprendre

• Lister et trier vos branches par date, auteur ou état de fusion
• Appliquer des conventions de nommage pour les branches de feature et fix
• Identifier et supprimer les branches obsolètes après fusion
• Gérer les branches locales et distantes de façon cohérente

Inspecter vos branches

Lister avec détails

# Branches locales avec dernier commit
git branch -v

Sortie :

  feature/auth   a1b2c3d Ajouter l'authentification JWT
  fix/header     e4f5g6h Corriger le z-index du header
* main           i7j8k9l Merge pull request #42

L’astérisque * indique la branche courante.

Filtrer par état de fusion

# Branches déjà fusionnées dans HEAD (supprimables)
git branch --merged

# Branches non encore fusionnées (travail en cours)
git branch --no-merged

Fusionnées dans quelle branche ?

Par défaut, --merged et --no-merged comparent avec HEAD. Pour comparer avec une autre branche :

git branch --merged main
git branch --no-merged develop

Trier par date

# Branches triées par dernier commit (les plus récentes en premier)
git branch --sort=-committerdate --format='%(committerdate:relative) %(refname:short)'

Sortie :

2 hours ago feature/auth
3 days ago fix/header
1 week ago main

Conventions de nommage

Une branche bien nommée renseigne instantanément sur son contenu. La convention la plus répandue utilise un préfixe/description :

Préfixe	Usage	Exemple
feature/	Nouvelle fonctionnalité	feature/user-profile
fix/	Correction de bug	fix/login-redirect
hotfix/	Correction urgente en production	hotfix/security-patch
chore/	Tâche technique (deps, CI, docs)	chore/update-eslint
refactor/	Refactoring sans changement fonctionnel	refactor/auth-module
release/	Préparation d’une release	release/2.1.0

Glissez pour voir

Règles de nommage

• Minuscules avec des tirets : feature/user-profile (pas Feature/UserProfile)
• Court et descriptif : 2 à 4 mots après le préfixe
• Pas d’espaces ni de caractères spéciaux (sauf / et -)
• Référence au ticket si applicable : fix/JIRA-123-login-error

Noms à éviter

• temp, test, wip sans contexte (personne ne sait ce que c’est dans 2 semaines)
• Des noms avec des points : feature/v2.0 (ambiguïté avec les tags)
• Le nom d’une branche supprimée récemment (risque de confusion avec le reflog)

Renommer une branche

# Renommer la branche courante
git branch -m nouveau-nom

# Renommer une branche spécifique
git branch -m ancien-nom nouveau-nom

Si la branche est déjà poussée, mettez à jour le remote :

git push origin -u nouveau-nom
git push origin --delete ancien-nom

Nettoyer les branches obsolètes

Supprimer les branches locales fusionnées

1. Vérifiez les branches fusionnées :

   git branch --merged main

2. Supprimez-les (sauf main et develop) :

   git branch --merged main | grep -vE '^\*|main|develop' | xargs -r git branch -d

   Cette commande :

   • Liste les branches fusionnées dans main
   • Exclut la branche courante (*), main et develop
   • Supprime chacune avec -d (refus si non fusionnée)

Supprimer les branches distantes obsolètes

Quand une branche a été supprimée sur le remote (après merge d’une PR), votre référence locale origin/feature/... persiste. Pour nettoyer :

# Voir les branches distantes périmées
git remote prune origin --dry-run

# Nettoyer effectivement
git remote prune origin

Ou en une seule commande à chaque fetch :

git fetch --prune

Pour en faire le comportement par défaut :

git config --global fetch.prune true

Automatisez le nettoyage

Ajoutez fetch.prune true à votre configuration globale. Chaque git fetch ou git pull nettoiera automatiquement les références distantes périmées.

Workflow de nettoyage complet

Voici un résumé des commandes à exécuter régulièrement :

# 1. Mettre à jour et nettoyer les refs distantes
git fetch --prune

# 2. Lister les branches locales fusionnées
git branch --merged main

# 3. Supprimer les branches fusionnées (sauf main/develop)
git branch --merged main | grep -vE '^\*|main|develop' | xargs -r git branch -d

# 4. Vérifier les branches restantes non fusionnées
git branch --no-merged main -v

Dépannage : problèmes courants

Symptôme	Cause probable	Solution
error: branch 'x' is not fully merged	Branche non mergée, -d refuse	Vérifiez avec git log main..x, utilisez -D si le travail est abandonné
Des branches origin/... obsolètes persistent	Remote non nettoyé	git fetch --prune
cannot rename the current branch	Vous êtes sur la branche à renommer	C’est normal, -m nouveau-nom fonctionne depuis la branche courante
La branche renommée n’est pas mise à jour sur le remote	Renommage local uniquement	Poussez le nouveau nom et supprimez l’ancien sur le remote

Glissez pour voir

À retenir

• git branch -v affiche les branches avec leur dernier commit
• --merged et --no-merged identifient les branches à nettoyer
• Utilisez une convention préfixe/description : feature/, fix/, hotfix/, chore/
• git fetch --prune nettoie les références distantes supprimées
• Nettoyez vos branches régulièrement pour garder un dépôt lisible

Prochaines étapes

Branches distantes Synchronisez vos branches avec les dépôts distants.

Cherry-pick Récupérez un commit précis d'une autre branche.

Rebase fondamental Réécrivez l'historique pour un graphe linéaire.

×

📖 Voir la documentation →