Git Zweig löschen: Wie man lokale und entfernte Zweige entfernt

Einen lokalen Git-Zweig löschen

Einen lokalen Zweig zu löschen ist nicht schwer; zum Glück ist es eine der einfacheren Git-Aufgaben. Wir schauen uns an, wie du am sichersten vorgehst und worauf du achten musst.

Der grundlegende Befehl zum Löschen eines lokalen Zweigs

Der sicherste Weg, einen lokalen Zweig zu löschen, ist das -d Flag:

git branch -d <branch_name>

Beachte, dass dieser Befehl nur funktioniert, wenn der Zweig vollständig mit dem aktuellen Zweig zusammengeführt wurde (normalerweise main oder master). Wenn es noch nicht gemachte Änderungen gibt, wird Git dich stoppen, um einen versehentlichen Datenverlust zu verhindern.

Erzwingen des Löschens eines lokalen Zweigs

Wenn du versuchst, einen Zweig zu löschen, der noch nicht gemeldete Änderungen enthält, lässt Git dich nicht, es sei denn, du erzwingst es:

git branch -D <branch_name>

Das -D Flag (beachte den Großbuchstaben) überspringt die Sicherheitsprüfung und löscht den Zweig sofort, egal ob er zusammengeführt wurde oder nicht. Ich würde dir dringend raten, dabei vorsichtig zu sein. Jede nicht gemischte Arbeit geht verloren, es sei denn, du hast ein Backup oder einen anderen Branch, der auf dieselben Commits zeigt.

Vor dem Löschen auf nicht markierte Änderungen prüfen

Bevor du einen Zweig löschst, solltest du prüfen, ob er noch nicht zusammengefasste Änderungen enthält. Du kannst dies mit tun:

git branch --no-merged

Der obige Befehl listet alle Zweige auf, die noch nicht mit dem aktuellen Zweig zusammengeführt wurden. Wenn die Datei, die du löschen willst, in dieser Liste erscheint, überprüfe noch einmal, dass du die Änderungen nicht brauchst, bevor du fortfährst.

Willst du eine Kurzreferenz für Git-Befehle, einschließlich des Löschens von Zweigen? Lade dase praktische Git Cheat Sheet herunter.

Einen entfernten Git-Zweig löschen

Das Löschen eines entfernten Zweigs ist etwas anders als das Löschen eines lokalen Zweigs. Da Remote-Zweige in gemeinsam genutzten Repositories existieren, hilft das Entfernen dieser Zweige dabei, Ordnung zu schaffen und zu verhindern, dass veraltete Zweige die Arbeitsabläufe im Team durcheinander bringen.

Der grundlegende Befehl zum Löschen eines entfernten Zweigs

Um einen Zweig aus einem entfernten Repository wie GitHub, GitLab oder Bitbucket zu löschen, verwendest du:

git push origin --delete <branch_name>

Dieser Befehl entfernt den Verweis auf den Zweig aus dem entfernten Repository und macht ihn für andere unzugänglich. Lokale Kopien des Zweigs auf anderen Rechnern sind davon jedoch nicht betroffen, sie müssen separat bereinigt werden.

Überprüfung der Löschung eines entfernten Zweigs

Nachdem du einen entfernten Zweig gelöscht hast, musst du bestätigen, dass er tatsächlich verschwunden ist. Als erstes holst du dir die neuesten Updates aus dem Remote-Repository:

git fetch --prune

Dadurch werden veraltete Verweise auf die Fernverfolgung entfernt. Um zu überprüfen, ob der Zweig nicht mehr aufgeführt ist, führe Folgendes aus:

git branch -r

Der obige Befehl zeigt alle verbleibenden entfernten Zweige an. Wenn der gelöschte Zweig immer noch auftaucht, versuche es mit einem anderen git fetch --prune oder stelle sicher, dass der Löschbefehl auf der richtigen Remote ausgeführt wurde.

Best Practices für das Löschen von Git-Zweigen

Das Löschen von Zweigen ist ein Routinevorgang bei der Arbeit mit Git, aber wenn du es richtig machst, kannst du dir unnötige Kopfschmerzen ersparen. Hier sind einige bewährte Methoden, um dein Repository zu organisieren und mögliche Fehler zu vermeiden.

Vermeide das vorzeitige Löschen von nicht zusammengeführten Zweigen

Bevor du einen Zweig löschst, vergewissere dich, dass er keine noch nicht gemerkten Arbeiten enthält, die noch benötigt werden. Wenn du dir unsicher bist, überprüfe den Status mit:

git branch --no-merged

Wenn der Zweig wertvolle Änderungen enthält, die noch nicht zusammengeführt wurden, solltest du sie zuerst zusammenführen oder archivieren, anstatt sie gleich zu löschen.

Nach dem Zusammenführen löschen

Sobald ein Feature oder eine Korrektur in den Hauptzweig (main oder master) eingefügt wurde, gibt es keinen Grund mehr, den alten Zweig zu behalten. Wenn du zusammengeführte Zweige löschst, vermeidest du Unordnung und kannst leichter erkennen, welche Zweige noch aktiv sind.

Kommuniziere mit deinem Team

Wenn du an einem gemeinsamen Projekt arbeitest, solltest du es aus Höflichkeit vermeiden, einen Zweig zu löschen, ohne dein Team zu informieren. Das kann zu Verwirrung führen - oder schlimmer noch, die Arbeit eines anderen stören. Bevor du einen entfernten Zweig entfernst, solltest du dich bei deinem Team vergewissern, dass er nicht mehr benutzt wird. Ich bevorzuge eine einfache Slack-Nachricht oder Notiz, um Frustration zu vermeiden.

Bevor du einen Zweig löschst, solltest du deinen Commit-Verlauf aufräumen, indem du Commits löschst. Wie das geht, erfährst du in unserem Git Squash Commits Tutorial.

Häufige Probleme beim Löschen von Git-Zweigen

Das Löschen von Zweigen in Git ist in der Regel problemlos, aber es gibt ein paar häufige Fallstricke, über die du stolpern kannst. Hier erfährst du, worauf du achten musst und wie du mit diesen Problemen umgehst, wenn sie auftauchen.

Löschen eines Zweigs, der nicht vollständig zusammengeführt wurde

Auch hier gilt: Wenn du versuchst, mit git branch -d einen Zweig zu löschen, der noch nicht gemeldete Änderungen enthält, wird Git dich daran hindern, um einen möglichen Datenverlust zu verhindern. Das ist eine Ausfallsicherung. Alle nicht gemerkten Arbeiten gehen verloren, wenn du sie mit -D zwangsweise löschst.

Wenn du einen Zweig bereits gelöscht hast und merkst, dass du ihn wieder brauchst, kannst du ihn vielleicht mit Git's reflog wiederherstellen:

git reflog
git checkout -b <branch_name> <commit_hash>

So kannst du den Zweig von seinem letzten bekannten Commit wiederherstellen, wenn er nicht komplett durch die Garbage Collection verloren gegangen ist.

Löschen des aktuellen Zweigs

Git lässt es nicht zu, dass du den Zweig löschst, in dem du dich gerade befindest, was sinnvoll ist, da du sonst ohne aktiven Zweig dastehen würdest. Wenn du beim Versuch, einen Zweig zu löschen, eine Fehlermeldung erhältst, wechsle zuerst zu einem anderen Zweig:

git checkout main

Oder, wenn du Git 2.23+ verwendest:

git switch main

Sobald du auf einem anderen Zweig bist, kannst du den Zweig, den du entfernen wolltest, sicher löschen.

Musst du zwischen Zweigen wechseln, bevor du einen löschst? Unsere Anleitung zum Auschecken eines entfernten Zweigs in Git führt dich durch den Prozess.

Versehentliches Löschen eines entfernten Zweigs

Wenn ein entfernter Zweig versehentlich gelöscht wurde, kannst du ihn wiederherstellen (vorausgesetzt, du hast noch eine lokale Kopie), indem du ihn auf den entfernten Zweig zurückschiebst:

git push origin <deleted_branch_name>

Dadurch wird der Zweig auf dem entfernten Repository neu erstellt und der Zugriff der Mitarbeiter wiederhergestellt. Wenn keine lokale Kopie existiert, musst du eventuell manuell deinen Commit-Verlauf überprüfen und den Zweig neu erstellen.

Warum kann ich einen Git-Zweig nicht löschen?

Wenn du Probleme hast, einen Zweig in Git zu löschen, überprüfe die allgemeinen Probleme: Überprüfe, ob er vollständig zusammengeführt wurde, ob du dich gerade auf dem Zweig befindest oder ob es sich um einen entfernten Zweig handelt. Von hier aus kann es an deinen Einstellungen oder Berechtigungen liegen.  

1. Als Erstes musst du prüfen, ob du dich gerade in diesem Zweig befindest. Git lässt es nicht zu, dass du einen Zweig löschst, an dem du gerade arbeitest, also musst du zuerst zu einem anderen Zweig wechseln. 
2. Wenn das nicht der Fall ist, kann es sein, dass der Zweig immer noch nicht gemeldete Änderungen enthält. Git schützt Zweige mit nicht gemergeder Arbeit. Wenn du also nicht absolut sicher bist, dass du diese Änderungen nicht brauchst, musst du den Zweig mit git branch -D branch-name zusammenführen oder zwangslöschen.
3. Wenn du versuchst, einen entfernten Zweig zu löschen, wird ein einfaches git branch -d nicht ausreichen. Stattdessen musst du git push origin --delete branch-name ausführen, und um alte Referenzen zu bereinigen, kannst du git fetch --prune verwenden. 
4. Einige Repositories, vor allem solche auf Plattformen wie GitHub oder GitLab, haben geschützte Zweige, die nicht gelöscht werden können, ohne die Einstellungen zu ändern. Wenn du in einem gemeinsam genutzten Repository arbeitest, brauchst du vielleicht auch die richtigen Rechte, um Zweige zu löschen.

Steckst du immer noch fest? Wenn du git branch -v ausführst, erhältst du mehr Informationen über den Status des Zweigs und kannst herausfinden, was los ist, bevor du es erneut versuchst.

Automatisierung der Zweigbereinigung mit Git

Ich liebe gute Automatisierung. Obwohl das manuelle Löschen von Zweigen gut funktioniert und du wissen solltest, wie man es macht, gibt es noch einen anderen Weg. Wenn du mit vielen Zweigen zu tun hast (z.B. in einem Team), kann die Automatisierung Zeit sparen und für mehr Ordnung sorgen. Git bietet einige Möglichkeiten, um das Aufräumen von Zweigen zu vereinfachen und so das Durcheinander zu reduzieren, ohne zusätzlichen Aufwand zu verursachen.

Automatisiere die Bereinigung entfernter Zweige

Wenn ein entfernter Zweig gelöscht wird, behält dein lokales Git noch einen Verweis darauf, bis du ihn manuell aktualisierst. Anstatt sie einzeln aufzuräumen, kannst du sie verwenden:

git fetch --prune

Der obige Befehl entfernt automatisch lokale Verweise auf Zweige, die im entfernten Repository nicht mehr existieren, damit alles synchron bleibt. Indem du dies regelmäßig tust, verhinderst du, dass sich veraltete Zweige in deinem lokalen Repo ansammeln.

Verwende Git-Hooks zum Aufräumen

Für Teams oder größere Projekte können Git-Hooks dabei helfen, das Aufräumen von Zweigen zu automatisieren. Hooks sind benutzerdefinierte Skripte, die an bestimmten Punkten im Git-Workflow ausgeführt werden, zum Beispiel nach dem Zusammenführen eines Zweigs. Du kannst einen Post-Merge-Hook so konfigurieren, dass zusammengeführte Zweige nach einer bestimmten Zeit automatisch gelöscht werden, damit alte Zweige nicht unnötig lange bestehen bleiben.

Fazit

Verzweigungen können mit der Zeit unübersichtlich werden, aber ein bisschen "Trimmen" hilft, dein Repository sauber und deinen Workflow effizient zu halten. Wenn du es dir zur Gewohnheit machst, zusammengeführte Zweige zu löschen, nicht zusammengeführte Zweige doppelt zu überprüfen und die Kommunikation in Teamprojekten offen zu halten, kannst du diese Probleme vermeiden. Und wenn du noch einen Schritt weiter gehen willst, können Automatisierungstools wie git fetch --prune und Git-Hooks dabei helfen, dein Repo ohne zusätzlichen Aufwand sauber zu halten.

Das Löschen von Zweigen ist nur ein Schritt, um Git zu beherrschen. Um dein Verständnis von Versionskontrolle zu vertiefen, schau dir den Kurs Git für Fortgeschrittene an. Wenn du mit GitHub-Repositories arbeitest, ist ein solides Verständnis der Kernkonzepte von GitHub unerlässlich. Erfahre mehr im Kurs Einführung in die GitHub-Konzepte!