Leggiamo la storia: log, diff, show e navigazione nel passato

La cronologia dei commit è come un diario del progetto

• Git log mostra la storia come un diario capovolto
• Ogni voce è un'istantanea delle modifiche
• Memorizza chi, quando e cosa è stato modificato
• Permette di vedere l'evoluzione del codice

Immaginate che ogni volta che salvate le modifiche in Git, stiate facendo una voce nel diario dello sviluppo. Il comando 'git log' mostra queste voci in ordine cronologico inverso — dalle più recenti alle più vecchie. In questo diario è conservata l'intera cronologia del progetto: chi, quando e quali modifiche ha apportato. Non è solo un elenco di modifiche, ma una storia viva dell'evoluzione del vostro codice. Saper leggere e analizzare questa storia è una competenza fondamentale per lavorare in team. È proprio attraverso la cronologia dei commit che vedete come si è sviluppato il progetto, quali decisioni sono state prese e perché. Approfondiamo ora la struttura di un singolo commit.

Leggere un commit: hash, autore, data

• commit: identificatore univoco tramite hash
• Author: chi e quando ha fatto le modifiche
• Date: timestamp del commit
• Messaggio: cosa è stato modificato

Osservate l'output del comando 'git log'. Ogni voce inizia con una lunga stringa di caratteri — è l'hash del commit, il suo identificatore univoco. Alla destra si vedono l'autore della modifica e la data in cui è stata apportata. Sotto c'è il messaggio del commit, scritto dallo sviluppatore al momento del salvataggio. Notate il formato: prima l'email dell'autore tra parentesi angolari, poi il timestamp. Questi dati aiutano a capire il contesto delle modifiche e, se necessario, contattare l'autore per chiarimenti. Ora che abbiamo analizzato la struttura di un commit, capiamo cos'è un hash e a cosa serve.

#!/bin/bash
cd ~/projects/git-course/
git log -1 --pretty=format:'commit %H%nAuthor: %an <%ae>%nDate:   %ad%n%n    %s'

L'hash del commit è la vostra chiave per la storia

• L'hash è un'impronta digitale del commit
• Dipende dal contenuto e dai metadati
• Cambiare anche un solo carattere modifica l'hash
• Permette di riferirsi con precisione a qualsiasi versione

L'hash del commit non è una stringa casuale, ma il risultato di una funzione crittografica che trasforma il contenuto del commit in una stringa univoca. Se modificate anche un solo byte nel commit, l'hash cambierà completamente. Questo garantisce l'integrità della cronologia delle modifiche. Conoscendo l'hash, potete accedere a qualsiasi versione del codice come a un segnalibro in un libro. Ad esempio, il comando 'git checkout' seguito dall'hash vi porterà allo stato del progetto al momento di quel commit. Questo è particolarmente utile per annullare modifiche o analizzare quando è comparso un bug. Ora che comprendiamo la struttura della storia, impariamo a filtrarla — perché nei progetti reali i commit possono essere migliaia.