Über dieses Tool
Gitmoji ist eine Community-Konvention — kein Git-Feature —, bei der Commit-Nachrichten ein Emoji vorangestellt wird, das die Absicht auf einen Blick zeigt: ✨ für ein neues Feature, 🐛 für einen Bugfix, 📝 für Dokumentation, ♻️ für ein Refactoring und rund 70 weitere für alles von CI-Änderungen bis zu Barrierefreiheits-Verbesserungen. Ein `git log` voller gitmoji-präfixierter Nachrichten lässt sich überfliegen, um zu erkennen, welche Art von Arbeit geleistet wurde, ohne jede Zeile zu lesen — manche Teams koppeln das Emoji sogar direkt an die Changelog-Erstellung oder an semver-Versionssprünge.
Dieses Cheatsheet listet jedes Emoji aus dem offiziellen Gitmoji-Datensatz mit seinem `:code:`-Shortcode, seiner Beschreibung und einer groben Kategorie auf und lässt Sie suchen oder nach Kategorie filtern, um schnell das richtige zu finden. Jede Zeile hat drei Kopier-Buttons: das Emoji selbst, den `:code:`-Shortcode mit einem nachgestellten Leerzeichen zum sofortigen Einfügen, oder eine vollständige Zeile `git commit -m ":code: "`, die Sie direkt ins Terminal einfügen und fertig tippen können. Alles läuft lokal in Ihrem Browser — nichts, was Sie eingeben, wird irgendwohin gesendet.
Dies ist eine unabhängige Referenz, die auf den Open-Source-Gitmoji-Daten von carloscuesta/gitmoji (MIT-Lizenz) basiert. Sie steht in keiner Verbindung zum Originalprojekt und wird nicht von ihm unterstützt — die kanonische Liste und offizielle Tools (einschließlich CLI und IDE-Erweiterungen) finden Sie unter gitmoji.dev.
Häufige Fragen
Was ist Gitmoji?
Gitmoji ist eine Community-Konvention, bei der Git-Commit-Nachrichten ein Emoji vorangestellt wird, das auf einen Blick zeigt, welche Art von Änderung der Commit vornimmt — ✨ für ein neues Feature, 🐛 für einen Bugfix, 📝 für Dokumentation und so weiter. Es ist kein Git-Feature und kein verpflichtender Standard, sondern lediglich eine Namenskonvention, die manche Teams und Open-Source-Projekte übernehmen, um die Commit-Historie leichter überfliegbar zu machen, und in manchen Workflows auch, um Changelog-Generierung oder automatische semver-Versionssprünge zu steuern.
Wie verwende ich Gitmoji in meinen Commit-Nachrichten?
Suchen Sie das Gitmoji, das zu Ihrer Änderung passt, und setzen Sie sein Emoji (oder seinen `:code:`-Shortcode, falls Ihr Git-Host oder Terminal Shortcodes wie GitHub-Kommentare darstellt) ganz an den Anfang der Commit-Nachricht, gefolgt von einer kurzen Beschreibung — zum Beispiel `✨ Add dark mode toggle` oder `:bug: Fix off-by-one error in pagination`. Der „Commit"-Kopier-Button dieses Tools baut den vollständigen `git commit -m ":code: "`-Befehl für Sie zusammen, den Sie direkt ins Terminal einfügen und dann nur noch fertig tippen müssen.
Ist das ein offizielles Gitmoji-Tool?
Nein — dies ist eine unabhängige Referenz, die auf den von Carlos Cuesta unter github.com/carloscuesta/gitmoji veröffentlichten Open-Source-Gitmoji-Daten (MIT-Lizenz) basiert. Sie steht in keiner Verbindung zu diesem Projekt, wird nicht von ihm unterstützt und ist nicht offiziell damit verknüpft; sie existiert lediglich, um das Suchen und Kopieren der bestehenden Gitmoji-Liste schneller zu machen. Die kanonische Liste, das offizielle CLI und IDE-Integrationen finden Sie unter gitmoji.dev.
Was bedeutet das kleine Label „major/minor/patch" neben manchen Gitmojis?
Das ist der Sprung bei der semantischen Versionierung (semver), den das Gitmoji-Projekt für einen Commit dieser Art vorschlägt, falls Ihr Projekt semver folgt und Versionssprünge automatisch aus der Commit-Historie ableitet — 💥 (boom) schlägt beispielsweise major vor, da es eine Breaking Change signalisiert, während ✨ (sparkles) minor vorschlägt, da es ein Feature hinzufügt, ohne etwas zu brechen. Viele Gitmojis, etwa 📝 (memo) für Dokumentation, haben gar keine Versionierungs-Bedeutung und bleiben leer. Betrachten Sie es als hilfreichen Hinweis, nicht als Regel, der Ihr Commit zwingend folgen muss — viele Teams nutzen Gitmoji rein aus Lesbarkeitsgründen, ganz ohne Versionierungsautomatisierung.