So nutzt du: Conventional Commit Generator
- Wähle den Typ der Änderung –
featfür ein neues Feature,fixfür einen Bugfix, oder docs, refactor, perf, test, build, ci, chore, style oder revert. - Ergänze optional einen Scope (den Teil des Codes, den die Änderung betrifft) und eine kurze Beschreibung im Imperativ: „hinzufügen“, nicht „hinzugefügt“.
- Erkläre im Body was und warum; setze den Haken bei Breaking Change und beschreibe die Migration, falls Nutzer etwas anpassen müssen.
- Füge Footer wie
Closes #123hinzu, behebe alles, was die Prüfungen markieren, und kopiere dann die Nachricht oder dengit commit-Befehl.
Das Conventional-Commits-Format
<type>[optional scope][!]: <description>
[optional body]
[optional footer(s)]| Typ | Verwendung für | Versions-Sprung |
|---|---|---|
feat | Ein neues Feature | Minor (1.4.0 → 1.5.0) |
fix | Ein Bugfix | Patch (1.4.0 → 1.4.1) |
! oder BREAKING CHANGE: | Eine Änderung, auf die Nutzer reagieren müssen | Major (1.4.0 → 2.0.0) |
| docs, style, refactor, perf, test, build, ci, chore, revert | Alles andere | Keiner (außer bei Breaking Change) |
Tools wie semantic-release, release-please und standard-version lesen diese Nachrichten, um die nächste Version zu wählen und das Changelog automatisch zu schreiben. commitlint erzwingt das Format in der CI oder einem Git-Hook. Halte den Header unter 72 Zeichen, schreibe die Beschreibung klein mit einem Verb im Imperativ und setze am Ende keinen Punkt. Ein Changelog erstellst du mit dem Changelog Generator, weitere Git-Befehle mit dem Git Command Generator.
Auch gesucht als: conventional commits, commit message generator, commit nachricht generator, git commit message format, semantic commit messages, commitlint, breaking change commit.
Passende Tools zu: Conventional Commit Generator
- Semver-Rechner — Alles rund um semantische Versionen an einem Ort: Vergleiche zwei Versionen, berechne die nächste Major/Minor/Patch/Prerelease-Version und sieh genau, welche Versionen ein npm-Range wie ^1.2.0 oder ~2.3 erlaubt – verständlich erklärt.
- Git Spickzettel — Jeder Git-Befehl, den du im Alltag brauchst, und die, die du brauchst, wenn etwas schiefgeht, in einer Zeile erklärt.
- GitHub Actions Workflow-Generator — Wähle deinen Stack, deine Trigger und Schritte aus und erhalte eine kommentierte .github/workflows/ci.yml — Installation, Zwischenspeicherung, Lint, Test, Build, eine Versionsmatrix und optional die Bereitstellung auf GitHub Pages, Vercel oder in einer Container-Registry.
- LICENSE-Datei Generator — Füge deinem Projekt in Sekunden die passende Open-Source-Lizenz hinzu.
Häufige Fragen
Was ist ein Conventional Commit?
Eine Commit-Nachricht im Format type(scope): description – zum Beispiel fix(auth): handle expired tokens –, die Tools auslesen können, um Versionsnummern zu bestimmen und Changelogs zu erstellen.
Wie kennzeichne ich eine Breaking Change?
Füge ein ! nach dem Typ oder Scope hinzu (feat(api)!: …) und einen Footer BREAKING CHANGE:, der erklärt, was sich geändert hat. Setze hier den Haken bei Breaking Change, dann werden beide erzeugt.
Was ist der Unterschied zwischen chore und refactor?
refactor verändert die Struktur des Codes, ohne das Verhalten zu ändern. chore umfasst Wartungsarbeiten, die das Verhalten des Quellcodes nicht berühren, etwa Abhängigkeiten oder die Konfiguration von Tools aktualisieren.
Wie schreibe ich eine mehrzeilige Commit-Nachricht über die Kommandozeile?
Verwende für jeden Absatz ein eigenes -m: git commit -m "header" -m "body" -m "footer". Der git-Befehl hier erledigt das für dich, inklusive Escaping der Anführungszeichen.
Kann ich Conventional Commit Generator als Web-App installieren und offline nutzen?
Ja. Conventional Commit Generator ist eine installierbare Web-App (PWA) – sie wird über Ihren Browser installiert und nicht aus einem App-Store heruntergeladen. Klicken Sie oben auf dieser Seite in Chrome oder Edge (Windows, macOS, Linux, ChromeOS) auf „App installieren“ oder verwenden Sie auf Android-Geräten „Teilen“ → „Zum Startbildschirm hinzufügen“ auf dem iPhone und iPad bzw. „Datei“ → „Zum Dock hinzufügen“ in Safari 17+ auf einem Mac. Die App öffnet sich dann in einem eigenen Fenster mit einem eigenen Symbol, und da sie vollständig in Ihrem Browser ausgeführt wird, funktioniert sie auch offline. Firefox auf dem Desktop kann keine Web-Apps installieren. So funktioniert die Installation.