2.3 Grunder i Git - Visa historiken

Efter att du har skapat flera versioner eller om du har klonat ett förvar med befintlig historik så vill du sannolikt blicka bakåt för att se vad som har hänt. Det mest grundläggande och kraftfulla verktyget för att göra detta är kommandot git log.

Dessa exempel använder ett väldigt simpelt projekt kallat “simplegit”. För att hämta projektet, kör

När du kör git log i projektet, så skall du få en utskrift som ser ut något liknande detta:

Som standard, utan argument, listar git log alla förbindningar som är gjorda i förvaret i omvänd kronologisk ordning; det vill säga att de nyaste förbindningarna kommer först. Som du ser listar kommandot varje förbindning med sin SHA-1 kontrollsumma, författarens namn och e-post, datumet den skrevs och versionsmeddelandet.

Det finns en mängd växlar tillgängliga för git log kommandot för att visa exakt det du eftersöker. Här kommer vi visa några av de vanligaste.

En av de mest hjälpfulla växlarna är -p eller --patch som visar skillnaden (patch utskriften) som introducerades i varje förbindning. Du kan också begränsa antalet loggposter som visas genom att skriva -2 för att bara visa de två senaste posterna.

Detta val visar samma information men med en diff som följer varje post. Detta är väldigt användbart för kodgranskning eller att snabbt skumma igenom vad som hänt under en serie av versioner som en medarbetare har lagt till. Du kan också använda en serie av summerande val tillsammans med git log. Om du till exempel vill se lite kortfattad statistik för varje förbindning använder du växeln --stat:

Som du ser gör kommandot --stat att det under varje förbindningspost listas modifierade filer, hur många filer som ändrats och hur många rader i filerna som lades till och togs bort. Den summerar även informationen på slutet.

En annat väldigt användbar växel är --pretty. Det gör att utskriftern formateras på ett annat sätt än normalt. En del inbyggda val finns tillgängliga att använda. Valet oneline skriver varje version på en rad, och är användbar om du tittar på många versioner. Sedan finns även valen short, full och fuller som skriver ut i ungefär samma format med mindre respektive mer information:

Det mest spännande valet är format, vilket låter dig specificera ditt eget format. Det är särskilt intressant när du genererar utskrift för tolkning av ett program — eftersom du specificerar formatet uttryckligen så vet du att det inte kommer att ändras i och med att Git själv uppdateras:

Användbara val för git log --pretty=format listar några av de mer användbara val som format hanterar.

Du kanske undrar vad som är skillnaden mellan author och committer. Det förra är författare, det vill säga den som ursprungligen gjorde arbetet, medan den senare är den som sparade versionen. Om du skickare en patch till ett projekt och någon projektmedlem använder din patch, kommer båda ni att anses bidragande till ändringen. — Du som författare, och projhektmedlemmen som den som sparade versionen. Vi kommer att gå igenom distinktionen lite mer i Distributed Git.

Valen oneline och format är särskilt användbara tillsammans med ett annat val till log, nämligen --graph. Detta valet visar en liten ASCII-graf som visar din versionshistorik:

Denna typen av utskrift blir mer intressant när vi går igenom förgreningar och ihopslagningar i nästa kapitel.

Dessa är bara några av de simpla formateringsvalen till git log — det finns massa fler. Vanliga val till git log listar valen som vi täckts hittils och några andra vanliga formateringsval som kan vara användbara, samt hur de förändrar utskriften av kommandot.