HOWTO · Git

Git Search Commit-Nachrichten über die Befehlszeile

In diesem Artikel wird erläutert, wie Sie Ihren Commit-Verlauf nach Commit-Nachricht herausfiltern können.

Auf dieser Seite

Um einen Commit in einer langen Historie zu finden, durchsuchen Sie die Commit-Nachrichten mit git log --grep. Die Option filtert Commits anhand eines Musters in ihrer Nachricht; sie durchsucht nicht die Dateien, die ein Commit geändert hat. Die folgenden Beispiele verwenden bei Bedarf ein kleines temporäres Repository, damit Sie die Befehle unabhängig ausführen können.

Commit-Nachrichten mit git log –grep durchsuchen

Übergeben Sie das Wort oder die Wortgruppe an --grep. Git behandelt den Wert als regulären Ausdruck. Ohne --regexp-ignore-case (oder -i) wird bei der Suche zwischen Groß- und Kleinschreibung unterschieden. Anführungszeichen verhindern, dass die Shell eine Wortgruppe in mehrere Argumente aufteilt.

Führen Sie dieses Beispiel aus. Der Code sowie die darin angezeigten Bezeichnungen und Ausgaben bleiben unverändert auf Englisch:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

repo=$(mktemp -d)
trap 'rm -rf "$repo"' EXIT
cd "$repo"
git init -q
git config user.name 'A. Developer'
git config user.email 'developer@example.test'
GIT_AUTHOR_DATE='2024-01-01T12:00:00Z' GIT_COMMITTER_DATE='2024-01-01T12:00:00Z' git commit --allow-empty -qm 'Update dependencies'
GIT_AUTHOR_DATE='2024-01-02T12:00:00Z' GIT_COMMITTER_DATE='2024-01-02T12:00:00Z' git commit --allow-empty -qm 'Document setup'
git log --format='%h %s' --grep='Update'

--oneline ist eine praktische Anzeigeoption, wenn Sie eine umfangreiche Historie durchsuchen. Sie kürzt die Anzeige jedes Commits, ändert aber nicht, welche Commits gefunden werden. Zum Beispiel wendet git log --oneline --grep='Update' denselben Nachrichtenfilter in einem kompakten Format an.

Filter für Commit-Nachrichten kombinieren

Wiederholte Optionen --grep finden standardmäßig einen Commit, wenn seine Nachricht einem beliebigen der angegebenen Muster entspricht. Das ist nützlich, wenn Sie nach mehreren möglichen Begriffen suchen. Zum Beispiel kann git log --grep='bug' --grep='fix' Nachrichten liefern, die einen der beiden Begriffe enthalten.

Fügen Sie --all-match hinzu, wenn ein Commit zu jedem --grep-Muster passen muss. Bei git log --all-match --grep='bug' --grep='login' muss die Nachricht zu beiden Mustern passen. Jedes Muster wird einzeln mit der Commit-Nachricht abgeglichen; die Begriffe müssen nicht direkt nebeneinander stehen. Diese Optionen lassen sich mit den übrigen Filtern von git log kombinieren, sodass Sie im selben Befehl auch einen Autor oder einen Datumsbereich angeben können.

Commit-Nachrichten mit regulären Ausdrücken durchsuchen

Der Wert von --grep ist ein regulärer Ausdruck und keine bloße wörtliche Teilzeichenfolge. Git verwendet standardmäßig einfache reguläre Ausdrücke. In diesem Modus bedeutet bug|fix nicht „bug oder fix“. Mit -E aktivieren Sie die erweiterte Syntax für reguläre Ausdrücke und damit die Alternation:

git log -E --grep='bug|fix'

Damit werden Nachrichten nach einer der beiden Alternativen durchsucht. Wenn eine wörtliche Zeichenfolge Satzzeichen aus der Regex-Syntax enthält, maskieren Sie diese entsprechend dem gewählten Regex-Modus. Verwenden Sie -i, wenn die Groß- und Kleinschreibung keine Rolle spielen soll. Auch diese Suche untersucht nur Commit-Nachrichten und keine Änderungen am Quellcode.

Commit-Nachrichten nach Datum oder Autor filtern

Kombinieren Sie die Nachrichtensuche mit --since und --until, um die berücksichtigten Commit-Daten einzugrenzen. Im Beispiel liegt die obere Datumsgrenze am Anfang des Februars, sodass der Befehl den Januar abdeckt:

git log --grep='feature' --since='2024-01-01' --until='2024-02-01'

Git interpretiert diese Werte als Datumsgrenzen: --since wählt Commits nach dem angegebenen Datum aus, --until Commits davor. Ein Datum ohne Uhrzeit wird nach den Datums- und lokalen Zeitzonenregeln von Git interpretiert. Wenn die Grenze genau sein muss, geben Sie daher eine Uhrzeit und Zeitzone an. Diese Optionen filtern Commit-Daten, nicht Datumsangaben im Nachrichtentext.

Um die Ergebnisse zusätzlich auf einen Autor einzugrenzen, fügen Sie --author hinzu. Auch sein Wert ist ein regulärer Ausdruck, der mit der Identität des Autors (Name oder E-Mail-Adresse) abgeglichen wird:

git log --grep='feature' --author='A. Developer'

Ersetzen Sie die Beispielidentität durch den Namen oder die E-Mail-Adresse, die bei den Commits eingetragen ist. Als Autor gilt die Person, der das Erstellen des Commits zugeschrieben wird. Sie kann sich von der Person unterscheiden, die den Commit als Committer übernommen hat. Nachrichten-, Autoren- und Datumsfilter werden kombiniert; ein gefundener Commit muss daher jeden dieser Filter erfüllen.

Commits finden, die mit git log -S Code hinzufügen oder entfernen

-S beantwortet eine verwandte, aber andere Frage: Die Option findet Commits, bei denen sich die Anzahl der Vorkommen einer Zeichenfolge in den geänderten Dateien verändert hat. Sie durchsucht den Patch-Inhalt, nicht die Commit-Nachricht. So lässt sich feststellen, wann ein bestimmtes Token oder ein API-Name hinzugefügt oder entfernt wurde. Geben Sie nach -- einen Pfad an, um die Suche auf eine Datei zu beschränken.

Führen Sie dieses Beispiel aus. Der Code sowie die darin angezeigten Bezeichnungen und Ausgaben bleiben unverändert auf Englisch:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

repo=$(mktemp -d)
trap 'rm -rf "$repo"' EXIT
cd "$repo"
git init -q
git config user.name 'A. Developer'
git config user.email 'developer@example.test'
printf 'def call():
    return "API"
' > app.py
git add app.py
GIT_AUTHOR_DATE='2024-01-01T12:00:00Z' GIT_COMMITTER_DATE='2024-01-01T12:00:00Z' git commit -qm 'Add API call'
printf 'def call():
    return "V2"
' > app.py
git add app.py
GIT_AUTHOR_DATE='2024-01-02T12:00:00Z' GIT_COMMITTER_DATE='2024-01-02T12:00:00Z' git commit -qm 'Rename API'
git log --format='%h %s' -S'API' -- app.py

Die Suche mit -S'API' findet Änderungen, bei denen sich die Anzahl genau dieser Zeichenfolge verändert hat, einschließlich des Hinzufügens und Entfernens im Beispiel. Sie findet nicht jede Änderung an einer Zeile, die zufällig API enthält, wenn die Anzahl der Vorkommen gleich bleibt. Verwenden Sie -G'<regex>', wenn Sie stattdessen Commits finden möchten, deren hinzugefügte oder entfernte Patch-Zeilen einem regulären Ausdruck entsprechen. Sowohl -S als auch -G durchsuchen Änderungen; --grep durchsucht Commit-Nachrichten.