Übersicht

git worktree add <path> [<branch>]
git worktree list
git worktree remove <path>
git worktree prune

Beschreibung

Der git worktree-Befehl erlaubt es, dass ein einzelnes Repository mehrere Working Trees gleichzeitig ausgecheckt hat, jeden auf einem anderen Branch. Das ist schneller und billiger als mehrfaches Klonen: nur eine Objektdatenbank, aber parallele Checkouts. Worktrees sind perfekt, um Tests auf einem Release-Branch zu laufen lassen, während die Entwicklung auf main weitergeht, oder um einen Notfall-Fix abzuholen, ohne laufende Arbeit zu stören.

Jedes Worktree hat sein eigenes HEAD, seinen eigenen Index und seine eigenen Arbeitsdateien, teilt aber die zugrunde liegenden Objekte und die Konfiguration. Gesperrte Worktrees verhindern automatisches Pruning von woanders gemounteten Checkouts.

Im täglichen Einsatz integriert sich git worktree eng mit Shell-Aliasen, Editor-Plugins und Continuous Integration. Power-User fügen oft Aliase hinzu, die Flags kombinieren, die sie immer übergeben, oder wickeln den Befehl in Skripte, die Teamkonventionen durchsetzen. Die Ausgabeformatierung kann über Git-Config angepasst werden — Pretty-Formate, Farbschemata und Pager-Verhalten sind alle einstellbar. Wenn etwas schiefgeht, ist der erste Diagnoseschritt üblicherweise, den Befehl erneut mit GIT_TRACE=1 in der Umgebung auszuführen, was die zugrunde liegenden Plumbing-Aufrufe offenlegt. Für ungewöhnliche Situationen öffnet die --help-Ausgabe (git worktree --help) die vollständige Manpage mit Details zu jeder Option, einschließlich solcher, die in alltäglichen Workflows selten verwendet werden, aber für Debugging oder Skripting im großen Maßstab essentiell sind.

Zu verstehen, wie git worktree mit dem Rest von Gits Datenmodell interagiert — der Objektdatenbank, dem Index, Refs und dem Working Tree — zahlt sich aus. Jeder Befehl operiert auf einer Teilmenge dieser Stücke, und zu wissen, welche er berührt, hilft Ergebnisse vorherzusagen und sich von Fehlern zu erholen. Das Lesen der offiziellen Git-Dokumentation neben praktischer Übung in einem Wegwerf-Repository ist der schnellste Weg, die Nuancen zu verinnerlichen. Die meisten Produktionsprobleme mit Git rühren von einer von drei Ursachen: überraschendem Standardverhalten, partiellen Netzwerkoperationen oder dem Umschreiben bereits geteilter Historie. Ein funktionierendes mentales Modell der Nebenwirkungen von git worktree hilft, alle drei zu vermeiden.

Häufige Optionen

Unterbefehl	Beschreibung
add <path> [<branch>]	Erstellt einen neuen Worktree.
add -b <new> <path> [<start>]	Erstellt neuen Branch + Worktree in einem Schritt.
list	Zeigt alle Worktrees.
remove <path>	Löscht das Verzeichnis und die Metadaten eines Worktrees.
prune	Entfernt Metadaten für Worktrees, deren Pfad weg ist.
lock / unlock	Verhindert oder erlaubt Pruning.
move <old> <new>	Verschiebt einen Worktree.

Beispiele

git worktree add ../project-hotfix release/1.4
    # release/1.4 in einem Geschwister-Verzeichnis auschecken

    git worktree add -b experiment ../project-experiment
    # Neuen Branch und Worktree erstellen

    git worktree list
    # Alle Worktrees anzeigen

    git worktree remove ../project-hotfix
    # Aufräumen, wenn fertig

Häufige Fehler

Sie können denselben Branch nicht gleichzeitig in zwei Worktrees ausgecheckt haben — Git verweigert das. Verwenden Sie --detach, falls Sie nur den Inhalt brauchen. Vergessen Sie nicht worktree remove, sonst bleiben veraltete Metadaten; git worktree prune räumt auf.

Verwandte Befehle

git switch, git branch, git clone, git submodule