git worktree
git
Syntaxe
git worktree add <path> [<branch>]Extrait un second dossier de travail du même dépôt pour mener deux branches en parallèle sans recloner ; une même branche ne peut pas être extraite deux fois, et supprimer le dossier à la main laisse une entrée jusqu'au prune.
Options courantes
| Option | Signification |
|---|---|
| add <path> <branch> | check that branch out into another folder |
| add -b <new> <path> | create a branch and check it out there |
| list | show every working tree of this repository |
| remove <path> | delete a working tree cleanly |
| prune | forget trees whose folder you deleted by hand |
| --detach | check out a commit without a branch |
Exemples
git worktree add ../hotfix hotfix/logina second folder on another branch, sharing one .git
git worktree add -b release ../rel maincreates release from main in ../rel
git worktree remove ../hotfixremoves the folder and its bookkeeping entry
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 worktree ?
Extrait un second dossier de travail du même dépôt pour mener deux branches en parallèle sans recloner ; une même branche ne peut pas être extraite deux fois, et supprimer le dossier à la main laisse une entrée jusqu'au prune.
Q. Comment l’écrire ?
git worktree add <path> [<branch>] — les crochets marquent ce qui est facultatif.
Q. Combien d’options valent la peine ?
Il y en a 6 ici ; la liste complète est dans man git. Cette commande relève de git.
Commandes liées
page man: man git-worktree