Übersicht

git switch [-c <new-branch>] [--detach] <branch>

Beschreibung

Der git switch-Befehl, eingeführt in Git 2.23, ist ein fokussierter Ersatz für die Branch-Wechsel-Hälfte von git checkout. Er wechselt nur Branches (oder erstellt und wechselt in einem Schritt). Er weigert sich, auf einzelnen Dateien zu operieren, was die häufigste Quelle der checkout-Fußangeln beseitigt. Wenn Sie heute Git lernen, bevorzugen Sie git switch für Branches und git restore für Dateien.

Wie checkout aktualisiert switch HEAD, den Index und den Working Tree, um zum Ziel-Branch zu passen. Er weigert sich zu wechseln, falls dadurch uncommitted Änderungen überschrieben würden, es sei denn, Sie übergeben --force.

Im täglichen Einsatz integriert sich git switch eng mit Shell-Aliasen, Editor-Plugins und Continuous Integration. Power-User fügen oft Aliase hinzu, die Flags kombinieren, die sie immer übergeben, oder wickeln den Befehl in Skripte, die Teamkonventionen durchsetzen. Die Ausgabeformatierung kann über Git-Config angepasst werden — Pretty-Formate, Farbschemata und Pager-Verhalten sind alle einstellbar. Wenn etwas schiefgeht, ist der erste Diagnoseschritt üblicherweise, den Befehl erneut mit GIT_TRACE=1 in der Umgebung auszuführen, was die zugrunde liegenden Plumbing-Aufrufe offenlegt. Für ungewöhnliche Situationen öffnet die --help-Ausgabe (git switch --help) die vollständige Manpage mit Details zu jeder Option, einschließlich solcher, die in alltäglichen Workflows selten verwendet werden, aber für Debugging oder Skripting im großen Maßstab essentiell sind.

Zu verstehen, wie git switch mit dem Rest von Gits Datenmodell interagiert — der Objektdatenbank, dem Index, Refs und dem Working Tree — zahlt sich aus. Jeder Befehl operiert auf einer Teilmenge dieser Stücke, und zu wissen, welche er berührt, hilft Ergebnisse vorherzusagen und sich von Fehlern zu erholen. Das Lesen der offiziellen Git-Dokumentation neben praktischer Übung in einem Wegwerf-Repository ist der schnellste Weg, die Nuancen zu verinnerlichen. Die meisten Produktionsprobleme mit Git rühren von einer von drei Ursachen: überraschendem Standardverhalten, partiellen Netzwerkoperationen oder dem Umschreiben bereits geteilter Historie. Ein funktionierendes mentales Modell der Nebenwirkungen von git switch hilft, alle drei zu vermeiden.

Häufige Optionen

Option	Beschreibung
-c <name>, --create	Erstellt einen neuen Branch und wechselt zu ihm.
-C <name>, --force-create	Erstellt oder setzt einen Branch zurück und wechselt zu ihm.
--track	Richtet Tracking mit einem Remote-Branch ein.
--detach	Wechselt im Detached-HEAD-Modus zu einem Commit.
-	Wechselt zum vorherigen Branch (wie cd -).
--discard-changes	Verwirft lokale Änderungen beim Wechseln.
-m, --merge	Three-Way-Merge der lokalen Änderungen beim Wechseln.

Beispiele

git switch main
    # Zum main-Branch wechseln

    git switch -c feature/search
    # Einen neuen Branch erstellen und zu ihm wechseln

    git switch -
    # Zum vorherigen Branch zurückwechseln

    git switch --detach v3.0.0
    # Einen Tag inspizieren, ohne einen Branch zu erstellen

Häufige Fehler

Eine häufige Verwirrung ist die Erwartung, dass git switch wie git checkout auf Dateien operiert. Das tut er nicht — verwenden Sie stattdessen git restore. Wenn Sie uncommitted Arbeit haben, die mit dem Ziel-Branch in Konflikt steht, schlägt das Wechseln fehl; entweder committen, stashen oder --merge verwenden, um einen Three-Way-Merge zu versuchen.

Verwandte Befehle

git checkout, git restore, git branch, git stash