Umbenennen eines Zweigs

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 covered by a branch protection or ruleset. People with admin permissions can rename the default branch and protected branches.

In diesem Artikel

Informationen zum Umbenennen von Branches

Sie können eine Verzweigung in einem Repository umbenennen auf GitHub.com. 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 die Standardverzweigung eines Repositorys umbenannt wird, werden auf der Startseite des Repositorys GitHub Anweisungen bereitgestellt, die die Mitwirkenden anleiten, ihre lokalen Git-Umgebungen zu aktualisieren.

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 Zweignamen ausführen.

          GitHub Actions Workflows folgen keine Umbenennungen. Wenn Ihr Repository also eine Aktion veröffentlicht, wird jede Person, die diese Aktion verwendet `@{old-branch-name}` , unterbrochen. Sie sollten in Erwägung ziehen, eine neue Verzweigung mit dem ursprünglichen Inhalt sowie einen zusätzlichen Commit hinzuzufügen, in dem der Verzweigungsname angegeben ist schließen und vorschlägt, dass Benutzer auf den neuen Verzweigungsnamen migrieren.

Wer kann eine Verzweigung umbenennen

Die meisten Verzweigungen können von jedem Benutzer mit Schreibberechtigung für das Repository umbenannt werden.

Einige Verzweigungen können nur von einem Repository-Administrator umbenannt werden: die Standardverzweigung des Repositorys und alle Verzweigungen, die von einem Branchenschutz oder einem Verzweigungsregelset auf Repositoryebene abgedeckt werden.

Wenn Regelsätze auf Organisationsebene oder Regelsätze auf Unternehmensebene Zielzweige in einem Repository anwenden, erfordert das Umbenennen dieser Zweige meistens einen Administrator der Organisation oder des Unternehmens.

Organisations- und Unternehmensbesitzer können Repositoryadministratoren jedoch erlauben, Verzweigungen umzubenennen, die von diesen Regelsätzen abgedeckt werden, vorausgesetzt, der name der neuen Verzweigung unterliegt weiterhin allen gleichen Regeln wie der aktuelle Name. Das Ändern der Standardverzweigung erfordert weiterhin einen Organisations- oder Unternehmensadministrator, wenn Regelsätze im Einsatz sind.

Weitere Informationen findest du unter Zulassen, dass Repository-Admins Branches mit Organisationsregeln umbenennen und Richtlinien zur Verwaltung von Repositories in Ihrem Unternehmen erzwingen.

Repositoryadministratoren können Branches erstellen und löschen, sofern sie über die entsprechenden Berechtigungen verfügen.

Umbenennen eines Zweigs

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Wähle in der Dateistrukturansicht das Dropdownmenü für Branches aus, und klicke anschließend auf View all branches. 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ählen Sie neben der Verzweigung, die Sie umbenennen möchten, das Dropdownmenü aus, und klicken Sie dann auf "Verzweigung umbenennen".

  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, wenn sich ein Branch-Name ändert

Nachdem Sie eine Verzweigung in einem Repository auf GitHub umbenannt haben, müssen alle Mitwirkenden mit einem lokalen Klon des Repositories diesen 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