Wie kann man einen Branch in TortoiseGit umbenennen?

1. Was bedeutet das Umbenennen eines Branches in Git?
2. Branch in TortoiseGit umbenennen – Lokalen Branch umbenennen
3. Remote Branch umbenennen und Verweis aktualisieren
4. Worauf ist beim Umbenennen eines Branches in TortoiseGit zu achten?
5. Zusammenfassung

In der Versionsverwaltung mit Git ist es manchmal notwendig, einen Branch umzubenennen, um die Benennung besser an den aktuellen Entwicklungsstand oder die Aufgabenstellung anzupassen. TortoiseGit, eine grafische Benutzeroberfläche für Git unter Windows, bietet hierfür verschiedene Möglichkeiten. Im Folgenden wird erläutert, wie man in TortoiseGit einen Branch umbenennen kann, welche Schritte notwendig sind und worauf man achten sollte.

Was bedeutet das Umbenennen eines Branches in Git?

Ein Branch-Name ist ein Verweis auf eine bestimmte Commit-Historie. Wenn man einen Branch umbenennen möchte, ändert man lediglich die Bezeichnung, unter der man diesen Entwicklungszweig findet. Das Umbenennen betrifft also nicht die Inhalte oder den Verlauf, sondern lediglich den Namen des Verweises. Da in Git lokale und entfernte Branches getrennt sind, muss bei Umbenennen eines Branches oft auch sichergestellt werden, dass dieser neue Name sowohl lokal als auch remote korrekt gesetzt wird.

Branch in TortoiseGit umbenennen – Lokalen Branch umbenennen

Um einen lokalen Branch in TortoiseGit umzubenennen, öffnet man zunächst das Kontextmenü im Windows Explorer auf dem Repository-Ordner und wählt TortoiseGit > Switch/Checkout. Im sich öffnenden Dialog lässt sich der derzeit aktive Branch auswählen. Möchte man den Branch umbenennen, sollte man sicherstellen, dass man sich nicht gerade auf dem Branch befindet, dessen Name geändert werden soll. Es ist empfehlenswert, vor dem Umbenennen auf einen anderen Branch zu wechseln.

Alternativ kann man auch mit der rechten Maustaste auf das Repository klicken, TortoiseGit > Show Log öffnen und dort unter References oder Branches mit Rechtsklick auf den Branch, den man umbenennen möchte, Optionen aufrufen. Leider bietet TortoiseGit keine direkte grafische Funktion Branch umbenennen. Trotzdem kann man dies mittels Befehlszeile über das TortoiseGit-Menü erledigen. Gehe dazu auf TortoiseGit > Git-Bash, in welchem ein Terminal geöffnet wird. Dort gibt man den Git-Befehl ein: git branch -m alterName neuerName. Dies ändert den lokalen Branch-Namen.

Remote Branch umbenennen und Verweis aktualisieren

Da Git keine direkte Möglichkeit bietet, einen remote Branch umzubenennen, muss man auf dem Remote-Repository den alten Branch löschen und den neuen hochladen. Über TortoiseGit lässt sich auch dies über die Git-Bash erledigen. Nach dem Umbenennen des lokalen Branches mittels git branch -m folgt die Aktualisierung auf dem Remote-Server mit:

git push origin :alterName (löscht den alten Branch remote)

git push origin neuerName (schiebt den umbenannten Branch an den Remote-Server)

Abschließend sollte die Referenz der Remote-Branches lokal aktualisiert werden, zum Beispiel mit git fetch -p oder über die TortoiseGit Aktion Fetch, um verwaiste Remote-Referenzen zu entfernen.

Worauf ist beim Umbenennen eines Branches in TortoiseGit zu achten?

Es ist wichtig zu beachten, dass das Umbenennen von Branches, die bereits von anderen Teammitgliedern benutzt werden, zu Verwirrungen führen kann. Da der Remote-Branch nicht direkt umbenannt wird, sondern gelöscht und neu angelegt wird, müssen auch andere Nutzer ihren lokalen Bezug entsprechend anpassen. Es empfiehlt sich, vor solchen Änderungen das Team zu informieren.

Zusätzlich sollte überprüft werden, ob beispielsweise automatisierte Deployments oder CI/CD-Pipelines von bestimmten Branch-Namen abhängig sind. Ein Umbenennen kann hier also weitreichende Auswirkungen haben.

Zusammenfassung

Das Umbenennen eines Branches in TortoiseGit erfordert in der Praxis die Nutzung der Git-Befehlszeile, da eine direktionale GUI-Funktion nicht vorhanden ist. Zuerst wird lokal mit git branch -m umbenannt, danach muss der alte remote Branch gelöscht und der neue gepusht werden. Dies kann über die Git-Bash von TortoiseGit bequem erledigt werden. Ein korrektes Umbenennen beinhaltet außerdem die lokale Aktualisierung der Referenzen und die Beachtung, dass andere Teammitglieder entsprechend ihre lokalen Branches anpassen müssen.