Übersicht
git commit-tree <tree> [-p <parent>]... [-m <msg>] [-S]Beschreibung
Der git commit-tree-Befehl erstellt ein neues Commit-Objekt aus einem Tree-SHA, einem oder mehreren Eltern-SHAs und einer Nachricht. Er ist das Plumbing-Pendant von git commit und der finale Schritt im manuellen Commit-Bau-Prozess.
Im täglichen Einsatz integriert sich git commit-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 commit-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 commit-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 commit-tree hilft, alle drei zu vermeiden.
Häufige Optionen
| Option | Beschreibung |
|---|---|
-p <parent> | Eltern-Commit (kann mehrfach für Merges sein). |
-m <msg> | Commit-Nachricht. |
-F <file> | Liest Nachricht aus Datei. |
-S | GPG-signiert den Commit. |
--no-gpg-sign | Überspringt Signierung. |
Beispiele
echo "Initial" | git commit-tree $(git write-tree)
# Einen Wurzel-Commit ohne Eltern erzeugen
git commit-tree $TREE -p $PARENT -m "msg"
# Standard-Commit mit einem Elternteil
git commit-tree $TREE -p $P1 -p $P2 -m "merge"
# Merge-Commit mit zwei ElternHäufige Fehler
Den resultierenden Commit-SHA als gespeichert anzunehmen ist falsch — Sie müssen git update-ref verwenden, um einen Branch oder eine andere Ref auf ihn zu zeigen, sonst verfällt er bei Garbage Collection.
Verwandte Befehle
git write-tree, git update-ref, git cat-file, git commit