Start·Terminal-Befehle

git worktree

git

Aufruf

git worktree add <path> [<branch>]

Checkt einen zweiten Arbeitsordner aus demselben Repository aus, sodass zwei Branches gleichzeitig gebaut werden können, ohne erneut zu klonen; derselbe Branch kann nicht zweimal ausgecheckt sein, und ein per Hand gelöschter Ordner bleibt bis zum prune eingetragen.

Häufige Optionen

OptionBedeutung
add <path> <branch>check that branch out into another folder
add -b <new> <path>create a branch and check it out there
listshow every working tree of this repository
remove <path>delete a working tree cleanly
pruneforget trees whose folder you deleted by hand
--detachcheck out a commit without a branch

Beispiele

git worktree add ../hotfix hotfix/login

a second folder on another branch, sharing one .git

git worktree add -b release ../rel main

creates release from main in ../rel

git worktree remove ../hotfix

removes the folder and its bookkeeping entry

Verwirrend ist, dass Rückgängig mehrere Formen hat — den Zeiger eines Branch zu verschieben ist nicht dasselbe wie einen Gegen-Commit zu setzen.

So liest man das

  • Eckige Klammern [ ] markieren einen Teil, den man weglassen kann.
  • Drei Punkte … heißen: mehrere sind erlaubt.
  • Optionen achten auf Groß- und Kleinschreibung — bei manchen Befehlen sind -r und -R verschieden.

Häufige Fragen

Q. Was macht git worktree?

Checkt einen zweiten Arbeitsordner aus demselben Repository aus, sodass zwei Branches gleichzeitig gebaut werden können, ohne erneut zu klonen; derselbe Branch kann nicht zweimal ausgecheckt sein, und ein per Hand gelöschter Ordner bleibt bis zum prune eingetragen.

Q. Wie gibt man ihn ein?

git worktree add <path> [<branch>] — eckige Klammern markieren, was wegfallen darf.

Q. Wie viele Optionen lohnen sich?

Hier stehen 6; die vollständige Liste steht in man git. Der Befehl gehört zu git.

Verwandte Befehle

man-Seite: man git-worktree