Quelle longueur doit faire un message de commit Git ?

La ligne de sujet doit faire 50 caracteres maximum. Si tu as besoin d'expliquer davantage, ajoute une ligne vide apres le sujet et ecris un corps detaille en coupant les lignes a 72 caracteres. Le sujet explique le "quoi", le corps explique le "pourquoi".

C'est quoi le format Conventional Commits ?

Conventional Commits est une specification qui structure les messages de commit avec un prefixe de type comme feat:, fix:, docs:, refactor:, test: ou chore:. Ca rend l'historique plus lisible et permet des outils automatises comme la generation de changelogs et le versioning semantique.

Faut-il ecrire les messages de commit en anglais ?

Il n'y a pas de regle absolue. L'important est que toute l'equipe utilise la meme langue. En pratique, l'anglais est prefere sur les projets open source et les equipes internationales. Pour un projet interne francophone, le francais convient tres bien.

Quand faut-il ecrire un corps de commit ?

Ecris un corps quand le "pourquoi" d'un changement n'est pas evident a partir du code. Les corrections de bugs, les decisions d'architecture et les compromis sont de bons candidats. Les changements simples comme corriger une faute de frappe n'ont generalement pas besoin de corps.

Peut-on modifier un message de commit apres coup ?

Oui, utilise "git commit --amend" pour modifier le dernier message de commit. Pour des commits plus anciens, il faut un rebase interactif avec "git rebase -i". Attention : modifier un commit change son hash, donc evite de le faire sur des branches partagees.

Messages de commit Git : les bonnes pratiques

Tes messages de commit sont la documentation de l'historique de ton projet. Apprends les regles, formats et habitudes qui les rendent vraiment utiles.

Pratiquer les commits Git Glossaire Git

gitquest — enquête

Anatomie d'un bon message de commit

Ligne de sujet (obligatoire)

Un resume court du changement, 50 caracteres maximum. Ecrit au mode imperatif ("Ajouter" et non "Ajoute" ou "Ajout de"). Pas de point a la fin.

feat: ajouter la verification email a l'inscription

Ligne vide (separateur)

Separe toujours le sujet du corps avec une ligne vide. Git utilise cette separation pour distinguer le resume de la description.

Corps (optionnel)

Explique pourquoi le changement a ete fait, pas quoi (le diff montre le quoi). Coupe les lignes a 72 caracteres. Reference les issues ou tickets quand c'est pertinent.

Les utilisateurs pouvaient s'inscrire avec des

emails invalides, causant des notifications en

erreur. Cet ajout verifie l'email avant

l'activation du compte.

Closes #187

Les regles d'or

7 regles pour des messages de commit parfaits

Ces conventions sont largement adoptees dans l'industrie. Suis-les et tes collegues te remercieront.

Sujet de 50 caracteres max

Force la concision. GitHub tronque apres 72 caracteres de toute facon.

Majuscule au debut du sujet

"Fix bug" et non "fix bug". Commence par une majuscule pour la coherence.

Pas de point a la fin

La ligne de sujet est un titre, pas une phrase. Chaque caractere compte dans 50 caracteres.

Utiliser le mode imperatif

"Ajouter" et non "Ajoute". Suit les conventions de Git lui-meme (ex: "Merge branch").

Ligne vide avant le corps

Necessaire pour que git log, shortlog et de nombreux outils fonctionnent correctement.

Corps coupe a 72 caracteres

Git ne coupe pas le texte automatiquement. Garde les lignes lisibles dans les terminaux.

Expliquer pourquoi, pas quoi

Le diff montre ce qui a change. Le message doit expliquer la motivation derriere le changement.

Le format Conventional Commits

Une convention populaire qui prefixe chaque message avec un type. Permet la generation automatique de changelogs et le versioning semantique.

feat:

Une nouvelle fonctionnalite pour l'utilisateur

feat: ajouter le mode sombre

fix:

Une correction de bug

fix: corriger le timeout de connexion

docs:

Modifications de documentation uniquement

docs: mettre a jour le guide de contribution

refactor:

Changement de code sans correction de bug ni ajout de fonctionnalite

refactor: simplifier le middleware auth

test:

Ajout ou mise a jour de tests

test: ajouter les tests e2e du checkout

chore:

Taches de maintenance (deps, CI, outillage)

chore: mettre a jour eslint en v9

Bon vs mauvais : trouve la difference

Compare un git log propre avec un git log brouillon. Sur quel projet prefererais-tu travailler ?

Bons messages

gitquest — bon log

# Un git log propre avec de bons messages

$git log --oneline -5

a3f7b21 feat: ajouter la verification email a l'inscription

e5c9d14 fix: empecher la double soumission du formulaire

b8a2e67 docs: mettre a jour le guide d'authentification API

1c4f9a3 refactor: extraire la logique de validation

d7e6b52 test: ajouter les tests unitaires du module paiement

Historique clair, lisible et informatif

Mauvais messages

gitquest — mauvais log

# Un git log illisible avec de mauvais messages

$git log --oneline -5

f2d8a91 fix truc

c7b3e45 WIP

9a1d6f3 modif

4e8c2b7 changements

6f5a9d1 asdfgh

Impossible de comprendre ce qui s'est passe

Avant et apres : reecrire les mauvais messages

Mauvais

fix truc

Qu'est-ce qui a ete corrige ? Ou ? Pourquoi ?

Bon

fix: empecher le crash quand le profil utilisateur est null

Type clair, portee et description de la correction.

Mauvais

mis a jour le code pour les nouvelles couleurs du design system et aussi change des styles de boutons et corrige quelques trucs dans le header

Beaucoup trop long, melange plusieurs changements, pas de structure.

Bon

refactor: migrer les styles de boutons vers les tokens du design system

Un changement par commit. Le reste dans des commits separes.

Mauvais

WIP

Pas un message de commit. Utilise les branches ou le stash pour le travail en cours.

Bon

feat: ajouter le composant barre de recherche (sans resultats pour l'instant)

Honnete sur l'etat d'avancement, mais toujours descriptif.

Ecrire ses commits : editeur vs en ligne

Utilise git commit pour des messages detailles ou -m pour les rapides.

Avec l'editeur (detaille)

gitquest — editeur

# Ecrire un message detaille avec l'editeur

$git commit

# Ouvre ton editeur par defaut avec :

feat: ajouter l'indicateur de force du mot de passe

Affiche une barre visuelle sous le champ mot de passe.

Utilise la librairie zxcvbn pour le calcul d'entropie.

Closes #234

[main a3f7b21] feat: ajouter l'indicateur de force du mot de passe

Avec le flag -m (rapide)

gitquest — en ligne

# Commit rapide avec le flag -m (messages courts)

$git commit -m "fix: empecher le crash sur saisie vide"

[main e5c9d14] fix: empecher le crash sur saisie vide

1 file changed, 3 insertions(+), 1 deletion(-)

# Ajouter sujet et corps avec deux flags -m

$git commit -m "refactor: extraire le middleware auth" -m "Deplacer la validation du token et la verification des roles dans un middleware reutilisable pour reduire la duplication."

[main b8a2e67] refactor: extraire le middleware auth

Fait partie du guide Les bases de Git

GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.

Questions sur les messages de commit

Pratique l'ecriture de bons commits dans un terminal securise

Les enquetes GitQuest te mettent face a des situations reelles ou des messages de commit clairs font toute la difference.

Commencer les enquetes