git branch
git
Syntaxe
git branch [-a|-vv] [-d <name>]Liste, crée et supprime des branches en local ; la supprimer ne touche pas le distant, le serveur exige git push origin --delete.
Options courantes
| Option | Signification |
|---|---|
| -a | local and remote-tracking branches |
| -r | remote-tracking branches only |
| -vv | last commit and upstream of each branch |
| -d <name> | delete a branch that is already merged |
| -D <name> | delete it even if unmerged; those commits are left behind |
| -m <old> <new> | rename |
| --merged | branches already contained in the current one |
| --show-current | print the branch you are on |
Exemples
git branch -vvevery local branch with its upstream and last commit
git branch -d old-featureremoves a merged branch locally only
git push origin --delete old-featurethe separate step that removes it on the server
Ce qui embrouille, c’est qu’annuler a plusieurs formes : déplacer là où pointe une branche n’est pas ajouter un commit qui l’inverse.
Comment lire
- Les crochets [ ] marquent une partie facultative.
- Les points de suspension … signifient qu’on peut en mettre plusieurs.
- Les options sont sensibles à la casse : sur certaines commandes, -r et -R ne font pas la même chose.
Questions fréquentes
Q. Que fait git branch ?
Liste, crée et supprime des branches en local ; la supprimer ne touche pas le distant, le serveur exige git push origin --delete.
Q. Comment l’écrire ?
git branch [-a|-vv] [-d <name>] — les crochets marquent ce qui est facultatif.
Q. Combien d’options valent la peine ?
Il y en a 8 ici ; la liste complète est dans man git. Cette commande relève de git.
Commandes liées
page man: man git-branch