Zum Inhalt

git switch

Wechselt zu einem anderen Branch und bringt die Dateien im Arbeitsverzeichnis auf dessen Stand.

git-switch output

Syntax

git switch [-c] BRANCH

Optionen

Option Beschreibung
BRANCH Zu diesem Branch wechseln; gibt es ihn nur auf dem Server, legt Git ihn lokal an
-c NAME, --create Einen neuen Branch anlegen und zu ihm wechseln
- Zurück zum vorherigen Branch
--detach COMMIT Einen Commit oder Tag ohne Branch ansehen (Detached HEAD)
--discard-changes Wechseln, auch wenn lokale Änderungen verloren gehen

Beispiele

Einen neuen Branch anlegen und zu ihm wechseln:

git switch -c rotate-logs
Switched to a new branch 'rotate-logs'

Zurück zu main:

git switch main
Switched to branch 'main'
Your branch is up to date with 'origin/main'.

An einem Branch arbeiten, den es bisher nur auf dem Server gibt:

git switch nginx-tls
Switched to a new branch 'nginx-tls'
branch 'nginx-tls' set up to track 'origin/nginx-tls'.

Eine alte Version ansehen:

git switch --detach v1.0
HEAD is now at 3fcc96a Also check /mnt/backup

git switch - bringt dich zurück zu dem Branch, von dem du kamst.

Nicht committete Änderungen im Weg:

git switch fix-paths
error: Your local changes to the following files would be overwritten by checkout:
        check-disk.sh
Please commit your changes or stash them before you switch branches.
Aborting

Committe die Änderung vorher oder leg sie mit git stash beiseite.

Wann brauche ich das?

  • Um eine neue Änderung in einem eigenen Branch zu beginnen
  • Um zwischen deiner Arbeit und main hin und her zu wechseln, etwa für eine dringende Korrektur
  • Um eine alte Version anzusehen, zum Beispiel die mit einem Tag markierte

git checkout macht dasselbe

Ältere Anleitungen nutzen git checkout BRANCH und git checkout -b NAME. git switch ist der neuere Befehl und erledigt nur diese eine Aufgabe.

Verwandte Befehle

git branch · git merge · git stash · git restore