Git Log: Die Commits eines Projekts auflisten und durch­su­chen

Git Log gibt Ihnen die Mög­lich­keit, alle Commits eines Projekts an­zu­zei­gen und zu filtern. Durch ver­schie­de­ne Spe­zi­fi­ka­tio­nen erzielen Sie dabei noch bessere Er­geb­nis­se.

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 Än­de­run­gen ge­spei­chert werden können. Gerade bei um­fang­rei­chen Projekten, die unter Umständen noch von größeren Teams be­ar­bei­tet werden, kommen dabei zahl­rei­che Commits zustande. Diese History kann daher ziemlich un­über­sicht­lich werden. Der Git-Command Git Log ist somit ein wichtiges Werkzeug für die Arbeit mit dem Ver­si­ons­kon­troll­sys­tem. Er erlaubt es Ihnen nämlich, Commits auf­zu­lis­ten, zu filtern und nach be­stimm­ten Än­de­run­gen zu durch­su­chen. Während Git Status das Ar­beits­ver­zeich­nis durch­fors­tet, kon­zen­triert sich Git Log nur auf durch­ge­führ­te Commits.

Die grund­sätz­li­che Syntax von Git Log ist sehr einfach. Ohne weitere Spe­zi­fi­ka­tio­nen listet Ihnen der Befehl sämtliche Commits Ihres Projekts in um­ge­kehr­ter chro­no­lo­gi­scher Rei­hen­fol­ge auf. Vom ak­tu­ells­ten Commit können Sie dann Schritt für Schritt zu den vor­he­ri­gen Snapshots scrollen. Dabei sind u. a. Datum sowie Name und E-Mail-Adresse des je­wei­li­gen Nutzers oder der Nutzerin auf­ge­lis­tet.

Diese Funktion ist zwar grund­sätz­lich gut, um einen ge­ne­rel­len Überblick zu erhalten. Gerade bei um­fang­rei­chen Projekten lohnt es sich al­ler­dings, die Such­kri­te­ri­en zu ver­fei­nern und dadurch bessere Er­geb­nis­se zu erhalten. Git bietet dafür zahl­rei­che Mög­lich­kei­ten. Die wich­tigs­ten haben wir für Sie in einer Tabelle hin­ter­legt, die Sie zu­sätz­lich zu Ihrem prak­ti­schen Git Cheat Sheet mit PDF-Download nutzen können.

Sie haben dabei auch die Mög­lich­keit, ver­schie­de­ne Argumente zu kom­bi­nie­ren und so eine noch exaktere Suche durch­zu­füh­ren. Ein einfaches Beispiel für eine sehr spe­zi­fi­sche Auf­lis­tung mit Git Log sehen Sie im folgenden Code. Mit diesem Befehl lassen Sie sich aus­schließ­lich die Commits des Nutzers Max Mus­ter­mann in der Bei­spiel­da­tei de­tail­liert anzeigen.

Für ein um­fang­rei­che­res Beispiel nehmen wir an, dass die Commits desselben Autors und einer Kollegin nur für den Zeitraum September und Oktober 2021 be­rück­sich­tigt werden sollen. Die Commits sollen aus­schließ­lich Än­de­run­gen im Text­ver­zeich­nis haben und keine Merges sein. Der ent­spre­chen­de Code sieht dann so aus:

Mit den pretty-Formaten können Sie die Dar­stel­lung bei Git Log ein­stel­len. Folgende Formate sind dabei gängig:

• oneline: Zeigt alle In­for­ma­tio­nen in einer Zeile.
• short: Listet lediglich Commit und Autor oder Autorin und Titel auf.
• medium: Listet Commit, Verfasser oder Ver­fas­se­rin, Datum, Titel und Erklärung auf.
• full: Fügt noch den Committer hinzu.
• fuller: Listet zu­sätz­lich Datum des Autors und des Com­mit­ters.
• email: Zeigt die In­for­ma­tio­nen im E-Mail-Format.
• raw: Listet die Commits exakt, wie sie hin­ter­legt wurden.
• format: Erlaubt Ihnen eine genaue For­ma­tie­rung nach eigenen Vor­stel­lun­gen; so können Sie wichtige In­for­ma­tio­nen z. B. in Satzform dar­stel­len, Absätze einbauen oder eine bestimmte Rei­hen­fol­ge der In­for­ma­tio­nen festlegen.

Grund­sätz­lich ist Git Log ein wichtiges Tool, um den Überblick über Ihr Projekt zu behalten und bestimmte In­for­ma­tio­nen zu filtern. Der Befehl wird häufig mit Git Diff verwendet und listet dadurch Än­de­run­gen zwischen zwei Commits auf. Das zeigt Ihnen nicht nur, wie sich Ihr Projekt im Laufe der Zeit gewandelt hat und welche Team­mit­glie­der bestimmte Aufgaben über­nom­men haben, sondern eignet sich auch für die Iden­ti­fi­ka­ti­on von Feh­ler­quel­len.