Übersicht

git grep [<options>] <pattern> [<tree-ish>...]

Beschreibung

Der git grep-Befehl durchsucht von Git verfolgte Dateien nach einem Muster. Er ist auf großen Repositories viel schneller als grep -r, weil er nur das durchsucht, was Git kennt (überspringt .git, Build-Outputs und ignorierte Dateien) und Gits optimierte Objektdatenbank verwendet. Sie können auch jede historische Revision oder jeden Tree durchsuchen, nicht nur die Arbeitskopie.

Muster können einfache Strings, Basic Regex (Standard), Extended Regex (-E) oder PCRE (-P, falls einkompiliert) sein. Verwenden Sie git grep statt grep -r in Skripten, die auf Git-Repositories operieren.

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

Häufige Optionen

Option	Beschreibung
-i	Match ohne Beachtung der Groß-/Kleinschreibung.
-n	Zeigt Zeilennummern.
-l	Listet nur passende Dateinamen auf.
-E	Erweiterte reguläre Ausdrücke.
-P	Perl-kompatible Regex.
-w	Match auf ganze Wörter.
--cached	Durchsucht den Index statt des Working Trees.
--untracked	Durchsucht auch untracked, nicht ignorierte Dateien.

Beispiele

git grep "TODO"
    # Jedes TODO in verfolgten Dateien finden

    git grep -n -i "deprecated" src/
    # Case-insensitive, mit Zeilennummern, unter src/

    git grep "fooBar" v1.0.0
    # Den Tree des v1.0.0-Tags durchsuchen

    git grep -E "^(import|from) " --and -e "json"
    # Kombinierte Muster: Zeilen, die mit import/from beginnen und json erwähnen

Häufige Fehler

Vergessen, dass git grep nur verfolgte Dateien durchsucht — neu hinzugefügte Dateien erscheinen nicht, es sei denn sie sind gestaged oder Sie übergeben --untracked. PCRE-Funktionen (\b, Lookbehind) erfordern ein mit PCRE-Unterstützung gebautes Git und das -P-Flag.

Verwandte Befehle

git log -S, git log -G, git ls-files, git show