Übersicht

git checkout-index [-a] [-f] [-u] [--prefix=<dir>] [<file>...]

Beschreibung

Der git checkout-index-Befehl extrahiert Dateien aus dem Index in den Working Tree. Er ist das Plumbing hinter git checkout <path> und git restore. Anders als seine Porcelain-Pendants ist er sehr gezielt: nur das Schreiben von Dateien aus dem Index, keine Branch-Wechsel oder Kontext-Operationen.

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

Häufige Optionen

Option	Beschreibung
-a	Bezieht alle Index-Einträge ein.
-f	Erzwingt Überschreiben vorhandener Working-Tree-Dateien.
-u	Aktualisiert Stat-Info im Index nach dem Auschecken.
--prefix=<prefix>	Stellt einen Pfad-Präfix beim Auschecken voran.
--stage=<n>	Checkt einen bestimmten Stage (1=base, 2=ours, 3=theirs).
--temp	Schreibt in temporäre Dateien.

Beispiele

git checkout-index -a -f
    # Jede Index-Datei in den Working Tree extrahieren

    git checkout-index --prefix=/tmp/snapshot/ -a
    # Alle Index-Inhalte unter /tmp/snapshot/ extrahieren

    git checkout-index --stage=2 -- conflicted.txt
    # Die "ours"-Version einer konfliktbehafteten Datei holen

    git checkout-index --temp -- src/main.c
    # In eine temporäre Datei extrahieren, gibt deren Pfad aus

Häufige Fehler

Vergessen Sie -f beim Überschreiben modifizierter Dateien — sonst verweigert checkout-index. Der --prefix-Wert muss mit einem Schrägstrich enden, damit das Setzen des Pfades wie erwartet funktioniert.

Verwandte Befehle

git restore, git checkout, git read-tree, git ls-files