Git Branch
Dernière mise à jour
git branch est la commande pour gérer les branches : elle les liste, les crée, les supprime et les renomme. Utilisée seule, elle liste vos branches locales en marquant la branche actuelle. Notez que git branch feature ne fait que créer une branche ; pour y basculer, utilisez git switch ou git checkout.
Essayez ces commandes dans le terminal playground : un vrai shell dans votre navigateur, rien à installer.
Syntaxe
| Command | What it does |
|---|---|
git branch | Liste les branches locales |
git branch -a | Liste les branches locales et distantes |
git branch feature | Crée une branche (sans y basculer) |
git branch -d feature | Supprime une branche fusionnée |
git branch -D feature | Force la suppression d'une branche non fusionnée |
git branch -m newname | Renomme la branche actuelle |
git branch --merged | Liste les branches fusionnées dans HEAD |
Cas courants
| Goal | Command |
|---|---|
| Voir toutes les branches, y compris les distantes | git branch -a |
| Voir l'upstream de chaque branche | git branch -vv |
| Nettoyer les branches fusionnées | git branch --merged |
| Créer et basculer en une seule étape | git switch -c feature |
FAQ git branch
Comment lister toutes les branches dans Git ?
Exécutez
git branch pour lister les branches locales, avec un astérisque marquant celle sur laquelle vous êtes. Ajoutez -a (git branch -a) pour inclure les branches de suivi distant, ou -r pour ne lister que les branches distantes. Utilisez git branch -vv pour voir également l'upstream de chaque branche et son statut en avance/en retard.Est-ce que git branch crée la branche et y bascule ?
Non -
git branch feature ne fait que créer la branche ; vous restez où vous êtes. Pour créer et basculer en une seule étape, utilisez git switch -c feature (ou l'ancien git checkout -b feature). git branch tout seul sert à la gestion, pas à la navigation.Comment supprimer une branche ?
Utilisez
git branch -d <name> pour supprimer une branche dont le travail est fusionné (Git refuse sinon, protégeant les commits non fusionnés), ou git branch -D <name> pour forcer la suppression quoi qu'il arrive. Vous ne pouvez pas supprimer la branche sur laquelle vous êtes actuellement - basculez d'abord ailleurs.Comment renommer une branche ?
Exécutez
git branch -m <newname> pour renommer la branche actuelle, ou git branch -m <oldname> <newname> pour en renommer une autre. Si la branche a déjà été poussée, vous devrez aussi la mettre à jour sur le dépôt distant - voyez la page git rename branch.Puis-je m'entraîner en ligne ?
Oui. Ouvrez le terminal playground pour exécuter
git branch dans un vrai shell dans votre navigateur - rien à installer. Le cours interactif et gratuit de Git de Coddy couvre aussi la gestion des branches étape par étape.Ressources associées
Plus de commandes Git
