Écrire de bons messages de commit
Le toi de demain te remerciera
⏱ Estim. ~8 min
01 · Lire
Un bon message de commit, c'est un cadeau au toi de demain (et à tes collègues). Il devrait expliquer pourquoi tu as fait ce changement, pas seulement ce que tu as changé. Des messages clairs rendent l'historique git vraiment utile.
💡 Imagine çaÉcrire un bon message de commit, c'est comme étiqueter le dos d'une photo. « Anniversaire des 3 ans, chez mamie » est super utile. « Photo » ne sert à rien. Quelques mois plus tard, ces étiquettes sont ta seule façon de te rappeler ce que représente chaque instantané.
Points clés
- Les bons messages expliquent pourquoi : 'Fix login timeout for slow connections'
- Les mauvais messages sont flous : 'fixed stuff', 'update', 'asdf'
- La première ligne doit être courte (50 caractères max), à l'impératif : 'Add', 'Fix', 'Update'
02 · Pratique terminal
Tu as un projet de blog avec du HTML et du CSS. On va dérouler le flux complet pour pratiquer l'écriture de bons messages de commit.
(Cette section est interactive — active JavaScript pour l'utiliser.)
03 · Pratique terminal
Stage tous les fichiers, prêts pour ton premier commit.
(Cette section est interactive — active JavaScript pour l'utiliser.)
04 · Pratique terminal
Ton premier commit devrait décrire ce que contient ce projet. N'écris pas juste 'first commit' — précise quel est ton point de départ.
(Cette section est interactive — active JavaScript pour l'utiliser.)
05 · Quiz
Lequel de ces messages de commit suit les bonnes pratiques ?
- "fixed stuff"
- "Add user login validation for email format"
- "update"
- "changes"
06 · Pratique terminal
Maintenant on ajoute une nouvelle fonctionnalité à ton blog — une barre de navigation.
(Cette section est interactive — active JavaScript pour l'utiliser.)
07 · Pratique terminal
Stage le fichier modifié.
(Cette section est interactive — active JavaScript pour l'utiliser.)
08 · Pratique terminal
Écris un message de commit pour cette modification. Décris ce que tu as ajouté, n'écris pas juste 'update'. Bons exemples : 'Add navigation bar to blog', 'Add nav links for Home, About, Contact'.
(Cette section est interactive — active JavaScript pour l'utiliser.)
09 · Quiz
Lequel de ces messages de commit suit le mieux les conventions pros ?
- "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"
Autres leçons de ce chapitre
⚠ L'expérience interactive complète nécessite JavaScript. Active-le et recharge la page.
※ Ce site est un projet éducatif indépendant — pas un produit officiel d'Anthropic. Claude™ est une marque déposée d'Anthropic, PBC.