Git & Version Control
Einen Branch, eine Referenz oder einen Objekt-Hash eingeben. Syntaxfehler und Namensempfehlungen bleiben getrennt.
Einen Namen oder Hash eingeben.
Die Prüfung läuft im Browser, ohne Repositoryzugriff oder Übertragung der Eingabe.
Ein Wert, maximal 4.096 UTF-16-Codeeinheiten. Jeweils 50 Diagnosen werden angezeigt.
Einen Namen oder Hash eingeben.
Git-Branch-Namen prüfen ist hilfreich, wenn Git einen scheinbar gewöhnlichen Namen ablehnt. Ein eingefügtes Leerzeichen, ein Punkt am Anfang einer Pfadkomponente oder die Endung .lock lässt sich in einer knappen Terminalmeldung leicht übersehen.
Entscheidend ist, was der Text bezeichnet. main funktioniert als Branchname, benötigt als einfache Referenz aber eine ausdrückliche Freigabe. Auch eine vierzigstellige Hexadezimalfolge kann je nach Hashverfahren ein vollständiger Name oder nur ein Präfix sein.
Mit diesem Werkzeug lassen sich Git-Branch-Namen prüfen und die betroffenen Positionen einzeln untersuchen. Der Eingabetext bleibt unverändert. Ein ASCII-Vorschlag steht daneben und ersetzt weder bedeutungsvolle Sonderzeichen noch Großbuchstaben ohne Ihre Entscheidung.
Ein kurzer Commit-Hash ist in einer Versionsnotiz praktisch. Das Abschneiden eines Präfixes belegt jedoch nicht, dass es nur ein passendes Objekt gibt. Der Bericht unterscheidet vollständige IDs und Abkürzungen und ergänzt keine fehlenden Zeichen.
Beim Moduswechsel bleibt die Eingabe erhalten. Prüfen Sie main als Branch und refs/heads/main als Referenz. Die Option für einstufige Referenzen hebt ausschließlich die Pflicht zu einem Schrägstrich auf.
SHA-1 verwendet 40, SHA-256 verwendet 64 Hexadezimalstellen für eine vollständige ID. Mit erlaubten Abkürzungen werden vier Stellen bis zur vollständigen Länge minus eins als verkürztes Format erkannt.
Die Automatik wartet nach Änderungen 350 ms. Ohne Automatik erscheint die Prüftaste; Ctrl/Cmd + Enter führt ebenfalls aus. Eine Diagnose anklicken, um zur betreffenden Zeile und Spalte zu springen.
Für Branches sind zusätzlich HEAD und ein führender Bindestrich ausgeschlossen. Git-Referenzen können bei Bedarf einstufig sein. Die Prüfung folgt den Regeln von git check-ref-format für wörtliche Namen, ohne frühere Checkout-Ziele aufzulösen.
ASCII-Steuerzeichen, Leerzeichen, verbotene Satzzeichen und Folgen wie .. oder @{ werden gemeldet. Eine Pfadkomponente darf weder mit einem Punkt beginnen noch mit .lock enden. Zeilen und Spalten beginnen bei eins; Spalten und JSON-Offsets zählen UTF-16-Codeeinheiten.
Der Generator verwendet kleine ASCII-Buchstaben, Ziffern und ._-/ und ersetzt andere Zeichen durch Bindestriche. Nach der Bereinigung wird der Vorschlag erneut geprüft. Nichtlateinische Schrift wird nicht transliteriert; ohne nutzbare Buchstaben oder Ziffern lautet die Ersatzform branch.
Der Bericht nennt Verfahren, Länge, vollständige oder abgekürzte Form und angezeigtes Präfix. Großgeschriebene Hexadezimalziffern bleiben erhalten. Vierzig Zeichen gelten bei SHA-256 als Abkürzung. Es werden weder Dateiinhalte gehasht noch IDs zwischen Algorithmen umgerechnet.
Für einen wörtlichen Namen eignet sich der Branchmodus. Lokal kann git check-ref-format --branch mit einem korrekt als Argument übergebenen Namen verwendet werden. main und master sind nicht allein deshalb syntaktisch verboten, weil Teams sie oft schützen. Ein gültiges Format garantiert noch keinen erfolgreichen Schreibvorgang.
Verboten sind ASCII-Steuerzeichen, Leerzeichen, ~, ^, :, ?, *, [ und der Rückwärtsschrägstrich. Zusätzlich gelten Regeln für Zeichenfolgen und Pfadkomponenten. Eine schließende Klammer ] oder ein Dollarzeichen ist hingegen nicht automatisch ein Git-Syntaxfehler; die Shell kann trotzdem eine besondere Behandlung verlangen.
Der Befehl prüft standardmäßig eine Referenz und erwartet darin einen Schrägstrich. Mit --branch wird der Kurzname im Branch-Namensraum geprüft. Wählen Sie den passenden Kontext, statt einen beliebigen Schrägstrich anzuhängen: Am Ende eines Namens wäre er wiederum ungültig.
Git ermittelt ein innerhalb des Repositorys eindeutiges Präfix. Die angeforderte Mindestlänge beträgt vier, der Standard hängt von core.abbrev ab. Sieben Zeichen sind hier nur die Voreinstellung für die Anzeige. Mit zusätzlichen Objekten kann eine früher eindeutige Kurzform mehrdeutig werden.
Dazu muss das betreffende Repository abgefragt werden. Beispielsweise kann git cat-file -e die Existenz eines passenden Objektausdrucks prüfen; ob es ein Commit ist, muss bei Bedarf zusätzlich festgelegt werden. Die richtige Zahl von Hexadezimalzeichen beweist weder Existenz noch Objekttyp.
Noch eine Frage?
Git-Branch-Namen prüfen erklärt die Schreibweise. Existenz, Eindeutigkeit und die tatsächliche Verwendbarkeit bestätigen Sie anschließend im Ziel-Repository.