Git-Branch-Name-Generator
Füge eine Ticket-ID und ihren Titel ein und erhalte einen ordentlichen, gültigen Branch-Namen wie feature/PROJ-1423-add-oauth-login sowie den Git-Befehl, um ihn anzulegen. Wähle Präfix, Trennzeichen und Längenlimit deines Teams einmal aus – sie werden gespeichert.
Zuletzt aktualisiert:
Tipp: Füge "PROJ-12: Fix crash" ein und lass die ID leer – die ID wird automatisch erkannt
0 = kein Limit. 50–60 hält Namen in Tools lesbar
Anleitung: Git-Branch-Name-Generator
- Gib die Ticket-ID ein (PROJ-123, #42) und den Titel des Tickets.
- Wähle den Branch-Typ, etwa feature oder bugfix, oder ein eigenes Präfix.
- Lege den Stil deines Teams fest: Trennzeichen, Schreibweise der Ticket-ID, Ticket-Position und maximale Länge.
- Klicke auf Generieren (der Name aktualisiert sich auch beim Tippen).
- Kopiere den Branch-Namen oder den Git-Befehl und führe ihn in deinem Terminal aus.
Gängige Präfixe für Branch-Typen
| Präfix | Verwendung | Beispiel |
|---|---|---|
| feature/ | Neue Funktionen | feature/PROJ-88-export-to-csv |
| bugfix/ oder fix/ | Nicht dringende Bugfixes auf dem Entwicklungs-Branch | fix/482-empty-upload-crash |
| hotfix/ | Dringende Fixes, abgezweigt von der Produktion | hotfix/OPS-77-webhook-retry-500 |
| release/ | Stabilisierung einer Version vor der Auslieferung | release/v2.4.0 |
| chore/ | Tooling, Abhängigkeits-Updates, Aufräumarbeiten | chore/update-eslint-config |
| docs/ | Nur Dokumentation | docs/api-auth-examples |
| refactor/ | Codeänderungen ohne neues Verhalten | refactor/split-user-service |
| test/ | Tests hinzufügen oder korrigieren | test/payment-edge-cases |
Die Typnamen entsprechen den Typen von Conventional Commits (feat, fix, chore, docs …), daher verwenden viele Teams dasselbe Wort im Branch-Namen und in der Commit-Nachricht.
Regeln, die dieser Generator anwendet
- Kleingeschriebene Wörter, mit Bindestrichen getrennt: vermeidet Konflikte durch Groß-/Kleinschreibung unter Windows und macOS, wo Feature/Login und feature/login kollidieren können.
- Nur ASCII: Akzente werden entfernt (café → cafe) und Symbole wie &, !, Emojis und Anführungszeichen werden weggelassen.
- Ticket-ID wie eingegeben oder in Großbuchstaben, weil Tracker-Integrationen meist Schlüssel wie PROJ-123 erkennen.
- Kürzen ganzer Wörter: Ist der Name zu lang, werden Wörter am Ende der Beschreibung entfernt, nie aus dem Präfix oder Ticket.
- Git-sicher: keine Leerzeichen, kein "..", kein ~ ^ : ? * [ \, keine führenden Punkte und kein abschließender Schrägstrich, Punkt oder ".lock".
Häufige Fragen
Was ist eine gute Namenskonvention für Git-Branches?
Ein gängiges Muster ist typ/TICKET-kurze-beschreibung, zum Beispiel feature/PROJ-1423-add-oauth-login. Der Typ gruppiert Branches, die Ticket-ID verknüpft die Arbeit mit deinem Tracker, und ein paar kleingeschriebene, durch Bindestriche getrennte Wörter sagen, worum es im Branch geht.
Welche Zeichen sind in einem Git-Branch-Namen nicht erlaubt?
Git lehnt Leerzeichen, Steuerzeichen, ~ ^ : ? * [ und Backslash ab, ebenso zwei Punkte hintereinander (..), die Folge @{, einen Bestandteil, der mit einem Punkt beginnt, und Namen, die auf / oder .lock enden. Dieser Generator ersetzt oder entfernt all diese Zeichen.
Sollte der Jira-Ticket-Schlüssel im Branch-Namen stehen?
Das wird empfohlen. Integrationen von Jira, GitHub, GitLab und Bitbucket können einen Branch mit einem Issue verknüpfen, wenn der Schlüssel (etwa PROJ-123) im Branch-Namen vorkommt, und alte Branches lassen sich so leicht nachverfolgen.
Wie lang sollte ein Branch-Name sein?
Git selbst hat praktisch kein Limit, aber Namen über etwa 50 bis 60 Zeichen sind in Terminals, CI-Logs und Pull-Request-Listen schwer zu lesen. Verwende drei bis sechs aussagekräftige Wörter nach der Ticket-ID.
Schrägstrich oder Bindestrich nach dem Typ?
Ein Schrägstrich (feature/login) ist die häufigste Wahl, weil viele Git-Tools durch Schrägstriche getrennte Namen als Ordner anzeigen. Beachte, dass es nicht gleichzeitig einen Branch namens feature und einen namens feature/login geben kann, weil Git sie als Datei und Ordner speichert.
Was ist der Unterschied zwischen git switch -c und git checkout -b?
Beide legen einen neuen Branch an und wechseln zu ihm. git switch -c wurde in Git 2.23 als klarerer Befehl zum Wechseln von Branches eingeführt; git checkout -b funktioniert in jeder Version.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.