Git Log: Die Commits eines Projekts auflisten und durchsuchen

Git Log gibt Ihnen die Möglichkeit, alle Commits eines Projekts anzuzeigen und zu filtern. Durch verschiedene Spezifikationen erzielen Sie dabei noch bessere Ergebnisse.

Der Befehl Git Commit steht in jedem Git-Tutorial weit am Anfang, schließlich sorgt er dafür, dass Snapshots eines aktuellen Stands erstellt und Änderungen gespeichert werden können. Gerade bei umfangreichen Projekten, die unter Umständen noch von größeren Teams bearbeitet werden, kommen dabei zahlreiche Commits zustande. Diese History kann daher ziemlich unübersichtlich werden. Der Git-Command Git Log ist somit ein wichtiges Werkzeug für die Arbeit mit dem Versionskontrollsystem. Er erlaubt es Ihnen nämlich, Commits aufzulisten, zu filtern und nach bestimmten Änderungen zu durchsuchen. Während Git Status das Arbeitsverzeichnis durchforstet, konzentriert sich Git Log nur auf durchgeführte Commits.

Die grundsätzliche Syntax von Git Log ist sehr einfach. Ohne weitere Spezifikationen listet Ihnen der Befehl sämtliche Commits Ihres Projekts in umgekehrter chronologischer Reihenfolge auf. Vom aktuellsten Commit können Sie dann Schritt für Schritt zu den vorherigen Snapshots scrollen. Dabei sind u. a. Datum sowie Name und E-Mail-Adresse des jeweiligen Nutzers oder der Nutzerin aufgelistet.

Diese Funktion ist zwar grundsätzlich gut, um einen generellen Überblick zu erhalten. Gerade bei umfangreichen Projekten lohnt es sich allerdings, die Suchkriterien zu verfeinern und dadurch bessere Ergebnisse zu erhalten. Git bietet dafür zahlreiche Möglichkeiten. Die wichtigsten haben wir für Sie in einer Tabelle hinterlegt, die Sie zusätzlich zu Ihrem praktischen Git Cheat Sheet mit PDF-Download nutzen können.

Sie haben dabei auch die Möglichkeit, verschiedene Argumente zu kombinieren und so eine noch exaktere Suche durchzuführen. Ein einfaches Beispiel für eine sehr spezifische Auflistung mit Git Log sehen Sie im folgenden Code. Mit diesem Befehl lassen Sie sich ausschließlich die Commits des Nutzers Max Mustermann in der Beispieldatei detailliert anzeigen.

Für ein umfangreicheres Beispiel nehmen wir an, dass die Commits desselben Autors und einer Kollegin nur für den Zeitraum September und Oktober 2021 berücksichtigt werden sollen. Die Commits sollen ausschließlich Änderungen im Textverzeichnis haben und keine Merges sein. Der entsprechende Code sieht dann so aus:

Mit den pretty-Formaten können Sie die Darstellung bei Git Log einstellen. Folgende Formate sind dabei gängig:

• oneline: Zeigt alle Informationen in einer Zeile.
• short: Listet lediglich Commit und Autor oder Autorin und Titel auf.
• medium: Listet Commit, Verfasser oder Verfasserin, Datum, Titel und Erklärung auf.
• full: Fügt noch den Committer hinzu.
• fuller: Listet zusätzlich Datum des Autors und des Committers.
• email: Zeigt die Informationen im E-Mail-Format.
• raw: Listet die Commits exakt, wie sie hinterlegt wurden.
• format: Erlaubt Ihnen eine genaue Formatierung nach eigenen Vorstellungen; so können Sie wichtige Informationen z. B. in Satzform darstellen, Absätze einbauen oder eine bestimmte Reihenfolge der Informationen festlegen.

Grundsätzlich ist Git Log ein wichtiges Tool, um den Überblick über Ihr Projekt zu behalten und bestimmte Informationen zu filtern. Der Befehl wird häufig mit Git Diff verwendet und listet dadurch Änderungen zwischen zwei Commits auf. Das zeigt Ihnen nicht nur, wie sich Ihr Projekt im Laufe der Zeit gewandelt hat und welche Teammitglieder bestimmte Aufgaben übernommen haben, sondern eignet sich auch für die Identifikation von Fehlerquellen.