Übersicht

git show [<options>] [<object>...]

Beschreibung

Der git show-Befehl zeigt Informationen über Git-Objekte an: Commits (mit Diff), Tags (Annotation + getaggtes Objekt), Trees (Datei-Auflistung) oder Blobs (Dateiinhalte). Ohne Argumente zeigt er den jüngsten Commit. Mit einem Pfad-Argument zeigt er die Datei, wie sie zu einer bestimmten Revision existierte.

git show ist das Standardwerkzeug, um einen einzelnen Commit im Detail zu inspizieren. Anders als git log -1 -p formatiert es sowohl annotated Tags als auch Tree-Auflistungen natürlich, was es nützlich macht, um Release-Tags zu untersuchen oder historische Dateiinhalte zu extrahieren.

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

Häufige Optionen

Option	Beschreibung
--stat	Fügt eine Diffstat-Zusammenfassung hinzu.
--name-only	Listet nur geänderte Dateinamen auf.
--pretty=<fmt>	Wählt Format: oneline, short, full, eigenes.
-s, --no-patch	Unterdrückt den Diff.
--show-signature	Verifiziert und zeigt GPG-Signaturen.
--word-diff	Hebt Änderungen auf Wortebene hervor.

Beispiele

git show HEAD
    # Jüngster Commit mit Diff

    git show v2.0.0
    # Einen annotated Tag anzeigen

    git show HEAD:src/main.c
    # Die Datei anzeigen, wie sie bei HEAD war

    git show --stat abc123
    # Nur das Diffstat für einen bestimmten Commit

Häufige Fehler

git show HEAD~1 (ein Commit vor HEAD) mit git show HEAD^1 (erster Elternteil von HEAD) verwechseln — sie sind auf linearer Historie äquivalent, unterscheiden sich aber bei Merges. Beachten Sie auch, dass git show HEAD:file einen Doppelpunkt verwendet, kein Leerzeichen, um eine Datei zu einer Revision anzugeben.

Verwandte Befehle

git log, git diff, git cat-file, git blame