Technologie

Wie kann man einen Git-Branch umbenennen?

Melden
  1. Einleitung
  2. Branch lokal umbenennen
  3. Branch remote umbenennen
  4. Branch umbenennen und Verfolgung aktualisieren
  5. Fazit

Einleitung

Das Umbenennen eines Branches in Git ist eine häufige Aufgabe, die sowohl lokal als auch remote durchgeführt werden kann. Manchmal wird ein Branch-Name nachträglich unpassend oder falsch gewählt, und um eine bessere Übersicht und Organisation im Repository zu gewährleisten, ist es sinnvoll, den Branch-Namen zu ändern. In diesem Artikel wird ausführlich erläutert, wie Sie einen Git-Branch umbenennen können.

Branch lokal umbenennen

Um einen Branch lokal umzubenennen, bietet Git einen einfachen Befehl. Wenn Sie sich bereits auf dem Branch befinden, den Sie umbenennen möchten, können Sie den Befehl git branch -m NeuerName verwenden. Das -m steht für move und ändert den Namen des aktuellen Branches. Haben Sie sich nicht auf dem Branch, den Sie umbenennen möchten, befinden sondern auf einem anderen, dann können Sie den alten und neuen Namen beim Befehl angeben, beispielsweise git branch -m AlterName NeuerName. Nach dem Umbenennen existiert der neue Branch lokal unter dem neuen Namen, während der alte Name nicht mehr existiert.

Branch remote umbenennen

Das Umbenennen eines Branches auf einem Remote-Server wie GitHub oder GitLab ist nicht ganz so direkt wie lokal. Remote-Branches können nicht einfach umbenannt werden, aber man kann den neuen Branch pushen und den alten löschen. Zunächst wird der neu umbenannte lokale Branch mit git push origin NeuerName auf das Remote-Repository übertragen. Danach sollte der alte Branch remote gelöscht werden, um Verwirrung zu vermeiden. Das erreichen Sie mit dem Befehl git push origin --delete AlterName. Mit diesem Vorgehen ist der Branch auf dem Remote-Server effektiv umbenannt.

Branch umbenennen und Verfolgung aktualisieren

Nach dem Umbenennen und Pushen des Branches empfiehlt es sich, die Tracking-Informationen anzupassen. Standardmäßig verfolgt ein lokaler Branch einen Remote-Branch gleichen Namens. Mit dem Befehl git branch --set-upstream-to=origin/NeuerName NeuerName wird die Beziehung aktualisiert, sodass der lokale Branch mit dem neuen Remote-Branch verbunden ist. So wird gewährleistet, dass Befehle wie git pull und git push weiterhin reibungslos funktionieren.

Fazit

Das Umbenennen eines Git-Branches ist eine wichtige Fähigkeit, um Ordnung in Ihrem Repository zu bewahren. Lokal gelingt die Umbenennung mit git branch -m, während für die Remote-Umbenennung ein Push des neuen Branches und das Löschen des alten notwendig sind. Das korrekte Setzen der Tracking-Informationen rundet die Prozedur ab und ermöglicht eine nahtlose Weiterarbeit mit dem umbenannten Branch.

0