Notice: This page requires JavaScript to function properly.
Please enable JavaScript in your browser settings or update your browser.
Impara Messaggi di Commit | Introduzione a Git
Nozioni Fondamentali di Git

bookMessaggi di Commit

Perché i messaggi di commit sono importanti

I messaggi di commit svolgono un ruolo cruciale nella comprensione della cronologia di un progetto. Messaggi di commit ben scritti facilitano la comprensione da parte dei collaboratori, degli sviluppatori futuri e anche di te stesso del motivo e del contesto di ogni modifica. Una cronologia dei commit chiara facilita la collaborazione, il debug e il processo di identificazione di modifiche specifiche nella timeline di un progetto.

Anatomia di un buon messaggio di commit

1. Sintesi e chiarezza

Un messaggio di commit deve essere sintetico e diretto. Deve comunicare chiaramente lo scopo del commit in una sola riga. Evitare ambiguità e fornire informazioni sufficienti per comprendere la modifica senza dover consultare il codice effettivo.

Bad: "Fixed a bug"
Good: "Fix issue with user authentication in login form"

2. Separare oggetto e corpo

Se sono necessari ulteriori dettagli, separare l'oggetto dal corpo del messaggio di commit con una riga vuota. L'oggetto deve riassumere la modifica, mentre il corpo può fornire contesto aggiuntivo, motivazioni della modifica e qualsiasi informazione rilevante.

Ecco un esempio di tale messaggio di commit:

Subject: "Add validation for user email input"

Body: "This commit introduces email format validation to ensure
that users provide a valid email address when registering. It
helps improve the overall data integrity of the system."

In questo caso, tuttavia, eseguiremo semplicemente il comando git commit senza il flag -m:

Si aprirà l'editor di testo predefinito di Git, dove è possibile scrivere un messaggio di commit dettagliato. Successivamente, è necessario salvarlo e uscire correttamente dall'editor di testo.

Eseguiamo un altro commit nel nostro repository:

Ecco il comando utilizzato per modificare il nostro file di testo:

Il messaggio di commit è il seguente:

Se non puoi modificare il file, premi il tasto i. Questo ti permette di entrare in modalità di modifica. Ancora una volta, per salvare le modifiche ed uscire da Vim, premi il tasto Escape e due lettere Z maiuscole.

Note
Nota

Se utilizzi un editor di testo predefinito diverso da Vim nel terminale e riscontri difficoltà, puoi facilmente trovare su internet come salvare le modifiche ed uscire.

3. Usa il modo imperativo

Scrivi i messaggi di commit utilizzando il modo imperativo, che fornisce una direzione per la modifica. Inizia l'oggetto con un verbo, come "Fix", "Add" o "Update".

Bad: "Fixed the issue with the login form"
Good: "Fix issue with user authentication in login form"
Tutto è chiaro?

Come possiamo migliorarlo?

Grazie per i tuoi commenti!

Sezione 1. Capitolo 10

Chieda ad AI

expand

Chieda ad AI

ChatGPT

Chieda pure quello che desidera o provi una delle domande suggerite per iniziare la nostra conversazione

Awesome!

Completion rate improved to 3.57

bookMessaggi di Commit

Scorri per mostrare il menu

Perché i messaggi di commit sono importanti

I messaggi di commit svolgono un ruolo cruciale nella comprensione della cronologia di un progetto. Messaggi di commit ben scritti facilitano la comprensione da parte dei collaboratori, degli sviluppatori futuri e anche di te stesso del motivo e del contesto di ogni modifica. Una cronologia dei commit chiara facilita la collaborazione, il debug e il processo di identificazione di modifiche specifiche nella timeline di un progetto.

Anatomia di un buon messaggio di commit

1. Sintesi e chiarezza

Un messaggio di commit deve essere sintetico e diretto. Deve comunicare chiaramente lo scopo del commit in una sola riga. Evitare ambiguità e fornire informazioni sufficienti per comprendere la modifica senza dover consultare il codice effettivo.

Bad: "Fixed a bug"
Good: "Fix issue with user authentication in login form"

2. Separare oggetto e corpo

Se sono necessari ulteriori dettagli, separare l'oggetto dal corpo del messaggio di commit con una riga vuota. L'oggetto deve riassumere la modifica, mentre il corpo può fornire contesto aggiuntivo, motivazioni della modifica e qualsiasi informazione rilevante.

Ecco un esempio di tale messaggio di commit:

Subject: "Add validation for user email input"

Body: "This commit introduces email format validation to ensure
that users provide a valid email address when registering. It
helps improve the overall data integrity of the system."

In questo caso, tuttavia, eseguiremo semplicemente il comando git commit senza il flag -m:

Si aprirà l'editor di testo predefinito di Git, dove è possibile scrivere un messaggio di commit dettagliato. Successivamente, è necessario salvarlo e uscire correttamente dall'editor di testo.

Eseguiamo un altro commit nel nostro repository:

Ecco il comando utilizzato per modificare il nostro file di testo:

Il messaggio di commit è il seguente:

Se non puoi modificare il file, premi il tasto i. Questo ti permette di entrare in modalità di modifica. Ancora una volta, per salvare le modifiche ed uscire da Vim, premi il tasto Escape e due lettere Z maiuscole.

Note
Nota

Se utilizzi un editor di testo predefinito diverso da Vim nel terminale e riscontri difficoltà, puoi facilmente trovare su internet come salvare le modifiche ed uscire.

3. Usa il modo imperativo

Scrivi i messaggi di commit utilizzando il modo imperativo, che fornisce una direzione per la modifica. Inizia l'oggetto con un verbo, come "Fix", "Add" o "Update".

Bad: "Fixed the issue with the login form"
Good: "Fix issue with user authentication in login form"
Tutto è chiaro?

Come possiamo migliorarlo?

Grazie per i tuoi commenti!

Sezione 1. Capitolo 10
some-alt