Comment utiliser : Générateur de Conventional Commits
- Choisissez le type de modification :
featpour une nouvelle fonctionnalité,fixpour une correction de bogue, ou docs, refactor, perf, test, build, ci, chore, style ou revert. - Ajoutez une portée facultative (la partie du code concernée) et une courte description à l’impératif : « ajoute », et non « ajouté ».
- Expliquez quoi et pourquoi dans le corps ; cochez Breaking change et décrivez la migration si les utilisateurs doivent modifier quelque chose.
- Ajoutez des pieds de message comme
Closes #123, corrigez ce que signalent les vérifications, puis copiez le message ou la commandegit commit.
Le format Conventional Commits
<type>[portée facultative][!]: <description>
[corps facultatif]
[pied(s) de message facultatif(s)]| Type | Utilisation | Hausse de version |
|---|---|---|
feat | Une nouvelle fonctionnalité | Mineure (1.4.0 → 1.5.0) |
fix | Une correction de bogue | Correctif (1.4.0 → 1.4.1) |
! ou BREAKING CHANGE: | Une modification à laquelle les utilisateurs doivent s’adapter | Majeure (1.4.0 → 2.0.0) |
| docs, style, refactor, perf, test, build, ci, chore, revert | Tout le reste | Aucune (sauf si incompatible) |
Des outils comme semantic-release, release-please et standard-version lisent ces messages pour choisir la version suivante et rédiger automatiquement le changelog ; commitlint les fait respecter en CI ou dans un hook git. Gardez l’en-tête sous 72 caractères, commencez la description en minuscules avec un verbe à l’impératif, et ne la terminez pas par un point. Générez un changelog avec le Générateur de changelog et d’autres commandes git avec le Générateur de commandes Git.
Aussi recherché comme : conventional commits, générateur conventional commits, générateur de message de commit, format message de commit git, messages de commit sémantiques, commitlint, feat fix commit, commit breaking change.
Outils complémentaires : Générateur de Conventional Commits
- Calculateur SemVer — Tout sur les versions sémantiques en un seul endroit : comparez deux versions, calculez la prochaine major/minor/patch/prerelease et voyez exactement quelles versions une plage npm comme ^1.2.0 ou ~2.3 autorise, expliqué en français simple.
- Aide-mémoire Git — Toutes les commandes Git que vous utilisez au quotidien, et celles dont vous avez besoin quand ça tourne mal, expliquées en une ligne.
- Générateur de workflows GitHub Actions — Choisissez votre pile, vos déclencheurs et vos étapes, puis obtenez un script commenté .github/workflows/ci.yml — installation, mise en cache, analyse syntaxique, test, compilation, une matrice de versions et, en option, un déploiement vers GitHub Pages, Vercel ou un registre de conteneurs.
- Générateur LICENSE — Ajoutez la licence open source adaptée à votre projet en quelques secondes.
Questions fréquentes
Qu’est-ce qu’un conventional commit ?
Un message de commit au format type(portée) : description — par exemple fix(auth) : handle expired tokens — que les outils peuvent lire pour déterminer les numéros de version et construire les changelogs.
Comment signaler un changement incompatible ?
Ajoutez ! après le type ou la portée (feat(api)!: …) ainsi qu’un pied de message BREAKING CHANGE: qui explique ce qui a changé. Cochez Breaking change ici pour obtenir les deux.
Quelle est la différence entre chore et refactor ?
refactor modifie la structure du code sans changer son comportement ; chore regroupe la maintenance qui ne touche pas au comportement du code source, comme la mise à jour des dépendances ou de la configuration des outils.
Comment écrire un message de commit sur plusieurs lignes en ligne de commande ?
Utilisez un -m par paragraphe : git commit -m "header" -m "body" -m "footer". La commande git générée ici le fait pour vous, en échappant les guillemets.
Puis-je installer Générateur de Conventional Commits en tant qu’application web et l’utiliser hors ligne ?
Oui. Générateur de Conventional Commits est une application web installable (PWA) : elle s’installe depuis votre navigateur, sans passer par une boutique d’applications. Cliquez sur « Installer l’application » en haut de cette page dans Chrome ou Edge (Windows, macOS, Linux, ChromeOS) ; sur Android, utilisez « Partager » → « Ajouter à l’écran d’accueil » sur iPhone et iPad ; ou « Fichier » → « Ajouter au Dock » dans Safari 17+ sur Mac. L’application s’ouvre alors dans sa propre fenêtre avec sa propre icône, et comme elle s’exécute entièrement dans votre navigateur, elle continue de fonctionner hors ligne. Firefox sur ordinateur de bureau ne permet pas d’installer d’applications web. Comment fonctionne l’installation.