À propos de cet outil
Gitmoji est une convention communautaire — pas une fonctionnalité de Git — qui consiste à préfixer les messages de commit par un emoji signalant leur intention d'un coup d'œil : ✨ pour une nouvelle fonctionnalité, 🐛 pour une correction de bug, 📝 pour la documentation, ♻️ pour un refactoring, et environ 70 autres couvrant tout, des changements de CI aux améliorations d'accessibilité. Parcourir un `git log` rempli de messages préfixés par gitmoji permet de repérer le type de travail effectué sans lire chaque ligne, et certaines équipes relient directement l'emoji à la génération du changelog ou aux montées de version semver.
Cet aide-mémoire répertorie chaque emoji du jeu de données officiel de gitmoji avec son code `:code:`, sa description et une catégorie approximative, et vous permet de rechercher ou de filtrer par catégorie pour trouver rapidement le bon. Chaque ligne comporte trois boutons de copie : l'emoji seul, le code `:code:` suivi d'un espace prêt à coller, ou une ligne complète `git commit -m ":code: "` que vous pouvez coller directement dans un terminal et compléter. Tout s'exécute localement dans votre navigateur — rien de ce que vous saisissez n'est envoyé où que ce soit.
Il s'agit d'une référence indépendante construite à partir des données open source de gitmoji de carloscuesta/gitmoji (licence MIT). Elle n'est ni affiliée ni approuvée par le projet original — pour la liste canonique et les outils officiels (dont un CLI et des extensions IDE), consultez gitmoji.dev.
Questions fréquentes
Qu'est-ce que gitmoji ?
Gitmoji est une convention communautaire qui consiste à préfixer les messages de commit Git par un emoji indiquant, d'un coup d'œil, le type de changement effectué — ✨ pour une nouvelle fonctionnalité, 🐛 pour une correction de bug, 📝 pour la documentation, etc. Ce n'est ni une fonctionnalité de Git ni une norme obligatoire ; c'est simplement une convention de nommage que certaines équipes et projets open source adoptent pour rendre l'historique des commits plus facile à parcourir, et dans certains flux de travail, pour générer automatiquement le changelog ou incrémenter la version semver.
Comment utiliser gitmoji dans mes messages de commit ?
Trouvez le gitmoji correspondant à votre changement, puis placez son emoji (ou son code `:code:`, si votre hébergeur Git ou votre terminal affiche les codes comme le font les commentaires GitHub) tout au début du message de commit, suivi d'une brève description — par exemple `✨ Add dark mode toggle` ou `:bug: Fix off-by-one error in pagination`. Le bouton de copie « Commit » de cet outil construit pour vous la commande complète `git commit -m ":code: "`, à coller directement dans votre terminal ; il ne vous reste qu'à taper le reste du message.
Est-ce un outil gitmoji officiel ?
Non — il s'agit d'une référence indépendante construite à partir des données open source de gitmoji publiées par Carlos Cuesta sur github.com/carloscuesta/gitmoji (licence MIT). Elle n'est ni affiliée, ni approuvée, ni officiellement liée à ce projet ; elle existe uniquement pour rendre la recherche et la copie de la liste gitmoji existante plus rapides. Pour la liste canonique, le CLI officiel et les intégrations IDE, consultez gitmoji.dev.
Que signifie la petite étiquette « major/minor/patch » à côté de certains gitmoji ?
Il s'agit de l'incrément de version sémantique (semver) que le projet gitmoji suggère qu'un commit de ce type implique, si votre projet suit semver et automatise les incréments de version à partir de l'historique des commits — par exemple, 💥 (boom) suggère un major car il signale un changement cassant, et ✨ (sparkles) suggère un minor car il ajoute une fonctionnalité sans rien casser. De nombreux gitmoji, comme 📝 (memo) pour la documentation, n'impliquent aucune incidence sur le versioning et sont laissés vides. Considérez cela comme une indication utile, pas une règle que votre commit doit obligatoirement suivre — de nombreuses équipes utilisent gitmoji uniquement pour la lisibilité, sans aucune automatisation de versioning.