Umbenennen einer Verzweigung

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.

In diesem Artikel

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 Sie einen Branch umbenennen, 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.

Wenn der Standardbranch eines Repositorys umbenannt wurde, 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. Sie sollten 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 closing down ist, und den Benutzerinnen vorschlägt, zum neuen Branchnamen zu migrieren.

Organisatorische Regelsätze, die sich auf Branches eines Repositorys beziehen, erlauben es dem Repositoryadministrator nicht mehr, Branches des betreffenden Repositorys umzubenennen oder die Standardbranch in eine andere Branch zu ändern. Repositoryadministratoren können Branches erstellen und löschen, sofern sie über die entsprechenden Berechtigungen verfügen.

Umbenennen einer Verzweigung

  1. Navigieren Sie auf GitHub 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. Wähle neben dem Branch, den du umbenennen möchtest, das Dropdownmenü aus, und klicke dann auf Rename branch.

  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