Git Branch um­be­nen­nen: lokal und remote

Sie können einen lokalen oder remote Git Branch um­be­nen­nen, indem Sie den -m-Befehl verwenden. Während dies beim lokalen Branch kein Problem ist, muss beim remote Branch zunächst die veraltete Version gelöscht und durch die neue ersetzt werden.

Git ist ein Ver­si­ons­ver­wal­tungs­sys­tem, welches seit 2005 li­zenz­frei und kostenlos er­hält­lich ist. Die Be­son­der­heit des Tools ist, dass zahl­rei­che Ent­wick­ler gleich­zei­tig und völlig autark an einem Projekt arbeiten können. Das liegt daran, dass Git nicht mit einem zentralen Re­po­si­to­ry arbeitet, sondern sich jeder Nutzer eine Kopie auf seinen lokalen Rechner laden kann. Diese fungiert gleich­zei­tig als Back-up. Git zeichnet sich durch seine einfache Hand­ha­bung aus und ist schnell zu erlernen. In unserem Digital Guide finden Sie ein Git-Tutorial, das Ihnen bei den ersten Schritten mit dem Tool hilft und dafür sorgt, dass Sie schon bald Ihre eigenen Projekte angehen können.

Um zu verstehen, wie der Rename eines Git Branches funk­tio­niert, ist es ratsam, sich zunächst einmal anzusehen, wie Git überhaupt aufgebaut ist und verwendet wird. Ganz ent­schei­dend ist hierbei das Git Re­po­si­to­ry. Das Ver­si­ons­kon­troll­sys­tem nutzt das Re­po­si­to­ry als eine Art Sam­mel­be­cken. Sämtliche Dateien aktueller und vor­an­ge­gan­ge­ner Versionen eines Projekts werden hier auf­be­wahrt und allen Ent­wick­lern zur Verfügung gestellt. Etwaige Än­de­run­gen lassen sich so einfach nach­voll­zie­hen, während Fehler schneller behoben werden können. Im Gegensatz zu Systemen wie SVN baut Git dabei nicht auf ein zentrales Re­po­si­to­ry, sondern auf zahl­rei­che lokale Kopien. An diesen kann jeder Ent­wick­ler ei­gen­stän­dig arbeiten.

Wenn sehr viele Ent­wick­ler an einem Projekt arbeiten und un­ter­schied­li­che Ansätze verfolgen, ist es umso wichtiger, Ar­beits­schrit­te zu trennen und dennoch den Überblick zu behalten. Hierfür werden bei Git so­ge­nann­te Branches verwendet. „Branch“ bedeutet „Ast“ oder auch „Ver­zwei­gung“, und dieses Bild passt gut, um sich die Be­schaf­fen­heit der Branches vor­zu­stel­len. So gehen von dem großen Stamm des gesamten Projekts zahl­rei­che kleine Ver­äs­te­lun­gen oder Ent­wick­lungs­li­ni­en ab, an denen autark ge­ar­bei­tet werden kann. Neue Features können mit Branches eingefügt oder Bugs schnell behoben werden. Der originale Code wird dabei al­ler­dings nicht verändert.

Es kann vorkommen, dass Sie einen Git Branch um­be­nen­nen müssen. Wenn die Benennung nämlich falsch ist und andere Ent­wick­ler damit wei­ter­ar­bei­ten, kann es zu Problemen kommen. Trotz der engen Ver­zah­nung und der ver­schie­de­nen Ab­zwei­gun­gen ist es al­ler­dings zum Glück kein Problem, wenn Sie einen Git Branch um­be­nen­nen möchten. Dafür nutzen Sie den -m-Befehl. Die ent­spre­chen­de Syntax folgt immer demselben Aufbau:

Un­ter­schie­de gibt es al­ler­dings zwischen Branches, die Sie lokal be­ar­bei­ten und jenen, die bereits remote sind. Im Folgenden erklären wir Ihnen die Ar­beits­schrit­te für beide Fälle.

Ein lokaler Git Branch ist lediglich auf Ihrem Rechner vorhanden. Hier führen Sie Än­de­run­gen und Tests durch, ohne dass andere Ent­wick­ler davon Notiz nehmen. Eine Um­be­nen­nung ist daher schnell durch­ge­führt.

1. Wählen Sie in der Kom­man­do­zei­le den Git Branch, den Sie um­be­nen­nen möchten, aus. Der Befehl dafür lautet „git checkout alter-name“.
2. Sie erhalten eine Be­stä­ti­gung, dass Sie den korrekten Branch aus­ge­wählt haben. Diese lautet „Switched to branch 'alter-name'“.
3. Nun führen Sie den ei­gent­li­chen Rename für den local Git Branch durch. Der passende Befehl dafür ist: „git branch -m neuer-name“.

Al­ter­na­tiv haben Sie die Mög­lich­keit, den Git Branch über den Master um­zu­be­nen­nen. Dafür nutzen Sie folgende Schritte:

1. Wechseln Sie in den Master über den Befehl „git checkout master“.
2. Geben Sie nun folgenden Befehl ein, wenn Sie einen Git Branch um­be­nen­nen möchten: „git branch -m alter-name neuer-name“.
3. Um si­cher­zu­stel­len, dass die Um­be­nen­nung er­folg­reich war, rufen Sie den aktuellen Status des Branches über den Befehl „git branch -a“ ab.

In einem remote Re­po­si­to­ry können Sie einen Git Branch nicht einfach um­be­nen­nen, da dies zu Kom­pli­ka­tio­nen führen würde. Statt­des­sen müssen Sie den alten Namen löschen und dann den Branch mit dem neuen Namen hin­zu­fü­gen. Auch dies ist glück­li­cher­wei­se nicht allzu schwer und kann mit ein paar einfachen Befehlen erledigt werden. Wie beim local Branch haben Sie zwei Optionen.

1. Ver­si­chern Sie sich zuerst, dass der local Branch den korrekten, neuen Namen hat. Der passende Befehl dazu lautet „git branch -a“.
2. Nun löschen Sie den Branch mit dem alten, falschen Namen aus dem remote Re­po­si­to­ry. Hierzu verwenden Sie folgenden Befehl: „git push origin --delete alter-name“.
3. Über­prü­fen Sie, dass der alte Branch ord­nungs­ge­mäß gelöscht wurde.
4. Jetzt fügen Sie den Branch mit dem korrekten Namen hinzu. Dafür nutzen Sie den Befehl „git push origin -u neuer-name“.
5. Zuletzt führen Sie einen Reset des Upstream Branches durch, um si­cher­zu­stel­len, dass die Än­de­run­gen wirksam sind.

Falls Sie den remote Git Branch mit nur einem Befehl um­be­nen­nen möchten, haben Sie al­ler­dings auch die folgende Option.

1. Geben Sie Sie folgenden Befehl ein: „git push origin :alter-name neuer-name“.
2. Dann führen Sie ebenfalls einen Reset des Upstream Branches wie oben be­schrie­ben durch.

Fehler passieren, und Git ist darauf ausgelegt, dass Sie Git Branches pro­blem­los um­be­nen­nen können. Das geht schnell und mit einigen wenigen Befehlen. Während der Vorgang bei lokalen Branches eine Um­be­nen­nung im ei­gent­li­chen Sinne ist, ist im remote Branch eine Löschung notwendig. Ist der Fehler behoben, lohnt sich eine sorg­fäl­ti­ge Über­prü­fung. Im Anschluss können Sie und andere Ent­wick­ler ohne Ein­schrän­kun­gen weiter an Ihrem Projekt arbeiten.