Imagine que tu travailles en méthode agile : au bout de trois sprints, tu as traité 25 tickets, donc créé 25 branches. Lance git branch, et tu obtiens une liste interminable. Pense toujours à nettoyer tes branches, en local et sur le serveur.

La situation de départ

git branch
#   feature/1
#   feature/2
#   feature/3
#   feature/4
# * master

On a la même liste sur le serveur.

Supprimer une branche mergée

feature/4 a été validée et mergée dans master. On la supprime en local :

git branch -d feature/4
# Deleted branch feature/4

Puis sur le serveur :

git push origin --delete feature/4

Rafraîchis la page du dépôt : la branche a disparu.

Attention : git push origin feature/4, sans --delete, pousse la branche au lieu de la supprimer. L’ancienne syntaxe git push origin :feature/4 fonctionne aussi pour supprimer.

Supprimer une branche non mergée

feature/3 n’a pas été mergée, et on veut quand même la supprimer :

git branch -d feature/3
# error: the branch 'feature/3' is not fully merged.

Git refuse : il pense que tu as oublié de merger la branche, et te protège contre la perte de travail. Si tu es sûr de toi, force la suppression avec -D (en majuscule, pour delete force) :

git branch -D feature/3
# Deleted branch feature/3

git push origin --delete feature/3

Un peu de ménage en plus

Quand une branche est supprimée sur le serveur par quelqu’un d’autre, ton dépôt local garde sa trace (origin/feature/x). Pour la retirer :

git fetch --prune

Récap

CommandeRôle
git branch -d <branche>Supprimer une branche locale mergée
git branch -D <branche>Forcer la suppression d’une branche locale non mergée
git push origin --delete <branche>Supprimer une branche sur le serveur
git fetch --pruneOublier les branches supprimées du serveur

Exercice · Le grand ménage

La branche feature/login est mergée. La branche test/essai ne l’est pas, mais tu n’en veux plus. Les deux existent en local et sur le serveur. Supprime-les partout.

Voir la solution
git branch -d feature/login
git push origin --delete feature/login

git branch -D test/essai
git push origin --delete test/essai

-d suffit pour la branche mergée. Pour test/essai, Git refuserait -d : il faut -D.

La suite

Dernier chapitre : git diff, pour vérifier exactement ce que tu as modifié avant de committer.


Ceci est le chapitre 10 du cours Git en pratique. Suis la série pour apprendre à utiliser Git au quotidien et en équipe.