Übersicht

git diff-index [--cached] [-p] <tree-ish> [<path>...]

Beschreibung

Der git diff-index-Befehl vergleicht ein gegebenes Tree-Objekt mit dem Index oder dem Working Tree. Er ist eines der Plumbing-Werkzeuge unter git diff und git status. Die Ausgabe ist im Roh-Format mit jedem geänderten Pfad und seinen alten/neuen Modi und SHAs.

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

Häufige Optionen

Option	Beschreibung
--cached	Vergleicht Tree mit Index statt mit Working Tree.
--name-only	Listet nur Dateinamen auf.
--name-status	Listet Dateinamen mit Status-Codes auf.
-z	NUL-terminierte Ausgabe.
-r	Rekurriert in Subtrees.
-M	Erkennt Umbenennungen.

Beispiele

git diff-index HEAD
    # Working Tree vs HEAD

    git diff-index --cached HEAD
    # Index vs HEAD (entspricht git diff --staged)

    git diff-index --name-status -r HEAD -- src/
    # Status pro Datei unter src/

    git diff-index HEAD > /dev/null || echo "dirty tree"
    # Schnell prüfen, ob es Änderungen relativ zu HEAD gibt

Häufige Fehler

Roh-Ausgabe in Skripten zu verlassen kann an Format-Updates über Versionen brechen — verwenden Sie --name-status oder -z für stabilere Ausgabe. Vergessen Sie --cached nicht, wenn Sie wirklich Index vs HEAD wollen.

Verwandte Befehle

git diff, git diff-tree, git ls-files, git status