Übersicht

git read-tree [-m | -u | --reset] <tree-ish>...

Beschreibung

Der git read-tree-Befehl liest einen oder mehrere Trees in den Index ein. Er ist eines der grundlegenden Plumbing-Bausteine und das Werkzeug, das hinter git checkout und git merge die Index-Updates handhabt.

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

Häufige Optionen

Option	Beschreibung
--reset	Setzt Index aus dem Tree zurück, einschließlich Löschungen.
-u	Aktualisiert Working-Tree-Dateien, um zum neuen Index zu passen.
-m	Drei-Wege-Merge zwischen Trees.
-i	Lädt nur in den Index (kein Working Tree).
--prefix=<prefix>	Liest Tree unter Pfad-Präfix in Index ein.
--empty	Leert den Index.

Beispiele

git read-tree HEAD
    # Index neu zum HEAD-Tree füllen

    git read-tree --reset -u HEAD
    # Index UND Working Tree auf HEAD zurücksetzen

    git read-tree --prefix=docs/ doc-branch:docs
    # Tree von doc-branch:docs unter docs/ in Index laden

    git read-tree --empty
    # Index leeren

Häufige Fehler

Direkt mit dem Index zu hantieren kann verwirrende Zustände erzeugen, die Porcelain nicht versteht. Verwenden Sie wenn möglich höhere Befehle. Vergessen, -u zu übergeben, lässt Working-Tree und Index inkonsistent.

Verwandte Befehle

git write-tree, git update-index, git checkout, git merge