Übersicht

git write-tree [--missing-ok] [--prefix=<dir>]

Beschreibung

Der git write-tree-Befehl erstellt ein Tree-Objekt aus dem aktuellen Index und gibt seinen SHA aus. Es ist der Plumbing-Schritt zwischen "der Index ist bereit zum Committen" und "wir haben einen Tree zum Verweisen". git commit ruft es intern auf.

Im täglichen Einsatz integriert sich git write-tree 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 write-tree --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 write-tree 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 write-tree hilft, alle drei zu vermeiden.

Häufige Optionen

Option	Beschreibung
--missing-ok	Akzeptiert fehlende Objekte stillschweigend.
--prefix=<prefix>	Schreibt Tree für Index-Einträge unter dem Präfix.

Beispiele

git write-tree
    # Den Tree-SHA des aktuellen Index ausgeben

    TREE=$(git write-tree)
    PARENT=$(git rev-parse HEAD)
    COMMIT=$(echo "msg" | git commit-tree $TREE -p $PARENT)
    git update-ref HEAD $COMMIT
    # Einen Commit komplett aus Plumbing bauen

Häufige Fehler

Den ausgegebenen Tree-SHA als irgendwo gespeichert anzunehmen ist falsch — er existiert in der Objektdatenbank, aber kein Ref zeigt darauf, bis Sie einen Commit erstellen, der ihn referenziert.

Verwandte Befehle

git read-tree, git commit-tree, git mktree, git ls-tree