Scrivere buoni messaggi di commit
Il tuo futuro ti ringrazierà
⏱ Stima ~8 min
01 · Leggi
Un buon messaggio di commit è un regalo per il te futuro (e per i tuoi colleghi). Dovrebbe spiegare perché hai fatto la modifica, non solo cosa. Messaggi chiari rendono davvero utile la storia di git.
💡 Immagina cosìScrivere buoni messaggi di commit è come etichettare le foto sul retro. "Festa di 3 anni a casa della nonna" è utile. "Foto" no. Dopo qualche mese, quelle etichette sono l'unico modo per ricordare cosa immortala ogni snapshot.
Punti chiave
- Un buon messaggio spiega il perché: 'Fix login timeout for slow connections'
- I messaggi pessimi sono vaghi: 'fixed stuff', 'update', 'asdf'
- La prima riga deve essere breve (max 50 caratteri), con imperativo: 'Add', 'Fix', 'Update'
02 · Pratica nel terminale
Hai un progetto blog con HTML e CSS. Proviamo il flusso completo scrivendo buoni messaggi di commit.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
03 · Pratica nel terminale
Metti tutti i file in stage e fai il tuo primo commit.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
04 · Pratica nel terminale
Il tuo primo commit dovrebbe descrivere cosa contiene il progetto. Non scrivere solo 'first commit' — sii specifico sul punto di partenza.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
05 · Quiz
Quale dei seguenti messaggi di commit segue le buone pratiche?
- "fixed stuff"
- "Add user login validation for email format"
- "update"
- "changes"
06 · Pratica nel terminale
Ora aggiungiamo una nuova funzionalità al blog — una barra di navigazione.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
07 · Pratica nel terminale
Metti in stage il file modificato.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
08 · Pratica nel terminale
Scrivi un messaggio di commit per questa modifica. Descrivi cosa hai aggiunto, non scrivere solo 'update'. Buoni esempi: 'Add navigation bar to blog', 'Add nav links for Home, About, Contact'.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
09 · Quiz
Quale messaggio di commit segue meglio le convenzioni professionali?
- "updated stuff"
- "asdfjkl"
- "Fix password reset for expired tokens"
- "I changed the login page to fix a bug where users couldn't log in when their session expired after 24 hours"
Altre lezioni di questo capitolo
⚠ L'esperienza interattiva completa richiede JavaScript. Attivalo e ricarica la pagina.
※ Questo è un progetto educativo indipendente — non è un prodotto ufficiale di Anthropic. Claude™ è un marchio di Anthropic, PBC.