Article original : Git Delete Branch – How to Remove a Local or Remote Branch
Git est un système de contrôle de version populaire et un outil essentiel dans la boîte à outils d'un développeur web.
Les branches sont une partie puissante et intégrale du travail avec Git.
Dans cet article, vous apprendrez les bases de la suppression des branches locales et distantes dans Git.
Qu'est-ce que les Branches dans Git ?
Une branche est un pointeur vers un commit.
Les branches Git sont un instantané d'un projet et de ses modifications, à partir d'un point spécifique dans le temps.
Lorsqu'on travaille sur un grand projet, il y a le dépôt principal avec tout le code, souvent appelé main ou master.
Le branchement vous permet de créer de nouvelles versions indépendantes du projet de travail principal original. Vous pourriez créer une branche pour l'éditer afin d'apporter des modifications, d'ajouter une nouvelle fonctionnalité, ou d'écrire un test lorsque vous essayez de corriger un bug. Et une nouvelle branche vous permet de faire cela sans affecter le code principal de quelque manière que ce soit.
Donc, pour résumer, les branches vous permettent d'apporter des modifications à la base de code sans affecter le code principal jusqu'à ce que vous soyez absolument prêt à implémenter ces modifications.
Cela vous aide à garder la base de code propre et organisée.
Pourquoi Supprimer des Branches dans Git ?
Vous avez donc créé une branche pour contenir le code d'une modification que vous souhaitiez apporter à votre projet.
Vous avez ensuite intégré cette modification ou cette nouvelle fonctionnalité dans la version originale du projet.
Cela signifie que vous n'avez plus besoin de conserver et d'utiliser cette branche, il est donc une bonne pratique courante de la supprimer pour éviter d'encombrer votre code.
Comment Supprimer une Branche Locale dans Git
Les branches locales sont des branches sur votre machine locale et n'affectent aucune branche distante.
La commande pour supprimer une branche locale dans Git est :
git branch -d nom_de_la_branche_locale
git branchest la commande pour supprimer une branche localement.-dest un drapeau, une option de la commande, et c'est un alias pour--delete. Il indique que vous souhaitez supprimer quelque chose, comme le suggère le nom. -nom_de_la_branche_localeest le nom de la branche que vous souhaitez supprimer.
Examinons cela un peu plus en détail avec un exemple.
Pour lister toutes les branches locales, vous utilisez la commande suivante :
git branch
J'en ai deux, les branches master et test2. Je suis actuellement sur la branche test2 comme le montre le (*) :
Je veux supprimer la branche test2, mais il n'est pas possible de supprimer une branche dans laquelle vous vous trouvez actuellement.
Si vous essayez de le faire, vous obtiendrez une erreur qui ressemblera à ceci :
Donc, avant de supprimer une branche locale, assurez-vous de basculer vers une autre branche que vous ne souhaitez PAS supprimer, avec la commande git checkout :
git checkout nom_de_la_branche
#où nom_de_la_branche est le nom de la branche vers laquelle vous souhaitez vous déplacer
#dans mon cas, l'autre branche que j'ai est master, donc je ferais :
#git checkout master
Voici le résultat :
Maintenant, je peux supprimer la branche :
La commande pour supprimer une branche locale que nous venons d'utiliser ne fonctionne pas dans tous les cas.
Si la branche contient des modifications non fusionnées et des commits non poussés, le drapeau -d ne permettra pas la suppression de la branche locale.
C'est parce que les commits ne sont pas vus par d'autres branches et Git vous protège contre la perte accidentelle de données de commit.
Si vous essayez de le faire, Git vous montrera une erreur :
Comme le suggère l'erreur, vous devrez utiliser le drapeau -D à la place :
git branch -D nom_de_la_branche_locale
Le drapeau -D, avec un D majuscule (qui est un alias pour --delete --force), supprime de force la branche locale, quel que soit son état de fusion.
Mais notez que vous devez utiliser cette commande avec prudence, car il n'y a pas de prompt vous demandant de confirmer vos actions.
Utilisez-la uniquement lorsque vous êtes absolument sûr de vouloir supprimer une branche locale.
Si vous ne l'avez pas fusionnée dans une autre branche locale ou poussée vers une branche distante dans la base de code, vous risquez de perdre toutes les modifications que vous avez apportées.
Comment Supprimer une Branche Distante dans Git
Les branches distantes sont séparées des branches locales.
Ce sont des dépôts hébergés sur un serveur distant qui peuvent être accessibles depuis celui-ci. Cela est en comparaison avec les branches locales, qui sont des dépôts sur votre système local.
La commande pour supprimer une branche distante est :
git push nom_du_remote -d nom_de_la_branche_distante
- Au lieu d'utiliser la commande
git branchque vous utilisez pour les branches locales, vous pouvez supprimer une branche distante avec la commandegit push. - Ensuite, vous spécifiez le nom du remote, qui dans la plupart des cas est
origin. -dest le drapeau pour la suppression, un alias pour--delete.nom_de_la_branche_distanteest la branche distante que vous souhaitez supprimer.
Maintenant, voyons un exemple de la manière de procéder pour supprimer une branche distante.
Pour afficher les branches distantes, vous utilisez cette commande :
git branch -a
Le drapeau -a (un alias pour --all) montre toutes les branches – locales et distantes.
J'ai deux branches locales appelées master et test et deux branches distantes origin/master et origin/test.
Le -r, un alias pour --remotes, montre uniquement les dépôts distants.
Je veux supprimer la branche distante origin/test, donc j'utilise la commande :
git push origin -d test
Résultat :
Cela a supprimé la branche test dans le dépôt distant nommé origin.
Le dépôt distant origin/test n'est plus là :
Conclusion
Vous savez maintenant comment supprimer des branches locales et distantes dans Git.
Si vous souhaitez en savoir plus sur Git, vous pouvez regarder les cours suivants sur la chaîne YouTube de freeCodeCamp :
- Pour apprendre à vous configurer avec Git, et pour un aperçu des commandes Git importantes et du flux de travail git typique – Git et GitHub pour débutants - Cours accéléré.
- Pour approfondir les branches et apprendre comment elles fonctionnent – Tutoriel sur les Branches Git.
Merci d'avoir lu et bon apprentissage !