Comment supprimer une branche Git localement et à distance : Guide expert complet

L'une des forces principales de Git réside dans ses branches légères. Elles permettent de travailler efficacement sur des étapes de développement parallèles. Un développeur peut créer des branches dédiées pour chaque bug distinct. Temporalement et en termes d'espace disque, les branches sont quasi gratuites.

De nombreux workflows Git gèrent à la fois des branches à long terme et temporaires. Il est donc fréquent de devoir supprimer des branches pendant le développement, y compris des branches partagées sur un serveur distant, en plus des locales.

Pourquoi supprimer une branche ?

Si vous débutez avec Git, vous créez souvent une branche pour tester une idée, puis réalisez qu'elle n'est plus nécessaire. Ou vous expérimentez et souhaitez nettoyer. C'est normal : créer une branche dans Git est une opération légère, rapide et économe en espace.

Les workflows Git encouragent la création de branches, même pour des tâches mineures comme une correction d'un bug sur une ligne. Ainsi, comprendre la création et la suppression de branches est essentiel pour un développement fluide.

Exemple de dépôt avec branches

Les exemples suivants utilisent ce dépôt :

$ git branch -vv
  dev               1ae41e8 [origin/dev] Premier commit
* main              1ae41e8 [origin/main] Premier commit

Chaque branche locale a une branche distante correspondante sur origin.

Supprimer une branche via la ligne de commande

Syntaxe de base :

git branch (-d | -D) [-r] <nom-branche>...

Pour supprimer une branche locale entièrement fusionnée :

$ git branch -d dev

Impossible de supprimer la branche active :

error: Cannot delete branch 'main' checked out at '/tmp/sandbox'

Confirmation de succès :

Deleted branch dev (was 1ae41e8).

Si des commits non fusionnés existent localement, Git refuse par défaut :

error: The branch 'dev' is not fully merged.
If you are sure you want to delete it, run 'git branch -D dev'.

Utilisez -D pour forcer. Git permet la suppression si la branche existe à distance :

warning: deleting branch 'dev' that has been merged to
'refs/remotes/origin/dev', but not yet merged to HEAD.
Deleted branch dev (was 9a6d20b).

Pour une branche distante :

$ git push -d origin dev
To github.com:bobbykjack/sandbox.git
 - [deleted]         dev

Supprimer des branches avec GitHub Desktop

GitHub Desktop ne permet de supprimer que la branche active via le menu Branche > Supprimer....

Impossible pour la branche par défaut (ex. main). Option pour supprimer aussi la distante :

Supprimer des branches avec GitKraken

Branches locales et distantes dans la barre latérale gauche. Survolez, cliquez sur les trois points > Supprimer <nom>.

Confirmation requise :

Changez de branche avant suppression :

Supprimer des branches avec Tower

Clic droit sur la branche dans le panneau gauche > Supprimer.

Option pour supprimer locale et distante :

Supprimer une branche sur GitHub

Sur la page Code > Branches > icône poubelle.

Aucune vérification de fusion ; suppression immédiate. Bouton Restaurer temporaire.

Supprimer des branches sur Bitbucket

Dans Branches > menu Actions > Supprimer. Pas pour la branche principale.

Suppression multiple possible :

La suppression de branches, essentielle au workflow Git

Les branches Git simplifient le développement quotidien. Créez et supprimez-les régulièrement pour un flux de travail propre et efficace.