Git Squash Commit: Combina i Commit per una Cronologia Pulita

Codegrind Team•Aug 28 2024

Il comando git squash commit è una tecnica potente per combinare più commit in uno solo, rendendo la cronologia del progetto più pulita e comprensibile. Questa tecnica è particolarmente utile quando hai creato una serie di commit piccoli o sperimentali e desideri condensarli in un unico commit prima di unirli nel branch principale. In questa guida, esploreremo come eseguire uno squash commit utilizzando il rebase interattivo in Git.

Cos’è il Git Squash Commit?

Git Squash Commit è il processo di combinare più commit in uno solo, mantenendo le modifiche del codice, ma riducendo il numero di commit nella cronologia del progetto. Questo è utile per mantenere la cronologia dei commit più ordinata e facile da navigare, specialmente prima di unire un branch secondario nel branch principale.

Perché Usare Git Squash?

Pulizia della Cronologia: Mantiene la cronologia dei commit lineare e priva di commit non necessari.
Migliorare la Leggibilità: Riduce il rumore nella cronologia, rendendo più facile per i collaboratori comprendere le modifiche.
Preparazione per il Merge: Prima di unire un branch di funzionalità nel branch principale, è utile combinare i commit per presentare un’unica unità di lavoro.

Come Eseguire uno Squash Commit con Git Rebase

Il metodo più comune per eseguire uno squash commit è attraverso un rebase interattivo. Questo ti permette di combinare commit specifici in uno solo mentre mantieni la cronologia lineare.

Passaggi per Eseguire uno Squash Commit

Identifica i Commit da Squashare: Innanzitutto, identifica i commit che vuoi combinare. Supponiamo di avere tre commit che vuoi squashare.
Avvia un Rebase Interattivo: Avvia un rebase interattivo, specificando quanti commit precedenti vuoi includere. Ad esempio, se vuoi squashare gli ultimi tre commit, esegui:
```
git rebase -i HEAD~3
```
Questo comando apre un editor di testo mostrando gli ultimi tre commit.
Modifica le Istruzioni di Rebase: Nell’editor, vedrai una lista di commit con la parola pick davanti a ciascuno di essi. Per combinare (squashare) i commit, cambia pick in squash (o s) per tutti i commit che vuoi combinare nel commit precedente.

Esempio:
```
pick a1b2c3d Commit iniziale
squash d4e5f6g Modifiche minori
squash g7h8i9j Correzione di bug
```
In questo esempio, i commit d4e5f6g e g7h8i9j verranno combinati nel commit a1b2c3d.
Salva e Chiudi l’Editor: Dopo aver modificato le istruzioni, salva e chiudi l’editor. Git eseguirà lo squash dei commit come specificato.
Modifica il Messaggio del Commit: Dopo aver eseguito lo squash, Git aprirà un editor per permetterti di combinare o modificare i messaggi dei commit. Qui puoi scrivere un messaggio di commit più conciso che rappresenta tutti i cambiamenti combinati.
Completa il Rebase: Salva e chiudi l’editor dopo aver modificato il messaggio del commit. Git completerà il rebase e combinerà i commit.

Esempio Pratico di Squash Commit

Supponiamo di avere i seguenti commit:

a1b2c3d (HEAD -> feature) Corregge bug X
d4e5f6g Ottimizza funzione Y
g7h8i9j Aggiunge test per Z

Vuoi combinare questi tre commit in uno solo. Esegui il rebase interattivo:

git rebase -i HEAD~3

Nell’editor di testo, modifica le istruzioni:

pick a1b2c3d Corregge bug X
squash d4e5f6g Ottimizza funzione Y
squash g7h8i9j Aggiunge test per Z

Salva e chiudi l’editor. Git ti permetterà di modificare il messaggio del commit:

Corregge bug X, ottimizza funzione Y e aggiunge test per Z

Salva e chiudi l’editor. Ora, la cronologia del tuo branch avrà un solo commit che rappresenta tutte e tre le modifiche.

Best Practices per l’Uso di Git Squash

Esegui Squash Prima del Merge: Esegui uno squash commit prima di unire un branch di funzionalità nel branch principale per mantenere una cronologia pulita.
Documenta il Commit Squashato: Scrivi un messaggio di commit chiaro e conciso che rappresenti tutte le modifiche combinate.
Verifica le Modifiche: Prima di eseguire uno squash commit, assicurati che tutte le modifiche siano corrette e che non ci siano errori che necessitano di commit separati.
Evita di Squashare Commits già Condivisi: Evita di eseguire squash commit su branch che sono già stati condivisi con altri, poiché riscrivere la cronologia potrebbe causare problemi di sincronizzazione.

Risolvere Problemi Comuni

Conflitti Durante il Rebase

Se incontri conflitti durante il rebase interattivo, Git interromperà il processo e ti chiederà di risolvere i conflitti manualmente. Risolvi i conflitti nei file coinvolti, usa git add per segnare i file come risolti, quindi continua il rebase con:

git rebase --continue

Squash Commits Non Voluti

Se hai eseguito uno squash commit per errore, puoi annullare il rebase con:

git rebase --abort

Questo comando ripristinerà il repository allo stato in cui si trovava prima di avviare il rebase.

Conclusione

Il comando git squash commit è uno strumento potente per mantenere la cronologia del tuo repository Git pulita e ordinata. Usando il rebase interattivo, puoi combinare più commit in uno solo, rendendo la cronologia più comprensibile per te e per i tuoi collaboratori. Seguire le best practices per eseguire squash commit ti aiuterà a gestire il tuo repository in modo più efficiente e a evitare problemi di gestione della cronologia.