Umbenennen einer Verzweigung

In diesem Artikel

Du kannst den Namen eines Branchs in einem Repository ändern.

Wer kann dieses Feature verwenden?

People with write permissions to a repository can rename a branch in the repository unless it is the default branch or a protected branch. People with admin permissions can rename the default branch and protected branches.

Informationen zum Umbenennen von Verzweigungen

Du kannst einen Branch in einem Repository auf GitHub.com umbenennen. Weitere Informationen zu Branches findest du unter Informationen zu Branches.

Wenn du einen Branch auf GitHub.com umbenennst, werden alle URLs, die den alten Branchnamen enthalten, automatisch an die entsprechende URL für den umbenannten Branch umgeleitet. Verzweigungsschutzrichtlinien werden ebenfalls aktualisiert, sowie die Basisverzweigungen für offene Pull Requests (einschließlich der Forks) und Entwurfsversionen. Wenn der umbenannte Branch die Head-Branch eines offenen Pull Requests ist, wird dieser Pull Request geschlossen.

Nachdem die Umbenennung abgeschlossen ist, stellt GitHub Anweisungen auf der Startseite des Repositorys bereit, die Mitwirkenden eine Anleitung zum Aktualisieren ihrer lokalen Git-Umgebungen geben.

Obwohl Datei-URLs automatisch umgeleitet werden, werden Roh-Datei-URLs nicht umgeleitet. Außerdem führt GitHub keine Umleitungen aus, wenn Benutzer einen git pull für den vorherigen Verzweigungsnamen ausführen.

Wenn dein Repository eine Aktion veröffentlicht, wird die Arbeit aller Benutzerinnen unterbrochen, die diese Aktion mit @{old-branch-name} verwenden, da GitHub Actions-Workflows keinen Umbenennungen folgen. Du solltest in Erwägung ziehen, einen neuen Branch mit dem ursprünglichen Inhalt und einem zusätzlichen Commit hinzuzufügen, der meldet, dass der Name des Branchs veraltet ist, und den Benutzerinnen vorschlägt, zum neuen Branchnamen zu migrieren.

Umbenennen einer Verzweigung

  1. Navigiere auf GitHub.com zur Hauptseite des Repositorys.

  2. Wähle in der Dateistrukturansicht auf der linken Seite das Branchdropdownmenü aus, und klicke dann auf Alle Branches anzeigen. Du findest das Branchdropdownmenü auch oben im integrierten Datei-Editor.

    Screenshot der Dateistrukturansicht für ein Repository, Ein Dropdownmenü für Branches ist aufgeklappt und dunkelorange umrandet.

  3. Klicke neben dem Branch, den du umbenennen möchtest, auf .

    Screenshot eines Branchs in der Branchliste. Das Stiftsymbol ist mit einem orangefarbenen Rahmen hervorgehoben.

  4. Gib einen neuen Namen für den Branch ein.

  5. Überprüfe die Informationen zu lokalen Umgebungen, und klicke dann auf Branch umbenennen.

Aktualisieren eines lokalen Klons nach Änderungen an einem Verzweigungsnamen

Nachdem du eine Verzweigung in einem Repository für GitHub umbenannt hast, muss jeder Projektmitarbeiter mit einem lokalen Klon des Repositorys den Klon aktualisieren.

Führe über den lokalen Klon des Repositorys auf einem Computer die folgenden Befehle aus, um den Namen des Standardbranchs zu aktualisieren.

git branch -m OLD-BRANCH-NAME NEW-BRANCH-NAME
git fetch origin
git branch -u origin/NEW-BRANCH-NAME NEW-BRANCH-NAME
git remote set-head origin -a

Führe optional den folgenden Befehl aus, um Nachverfolgungsverweise auf den alten Branchnamen zu entfernen.

git remote prune origin