Git: Remote-Branch auschecken (einfach erklärt)

Tutorial: So checkst du einen Remote-Git-Branch aus – mit einem oder mehreren Remotes, verständlich und ohne Stolperfallen.

Dieser Artikel hat eine Lesedauer von 1 minute Minuten.

Git: Remote-Branch auschecken (einfach erklärt)

Remote-Branches sieht man ständig (origin/main, origin/test) aber sie lassen sich nicht direkt bearbeiten.

Die typische Frage lautet daher: Wie checke ich einen Remote-Git-Branch korrekt aus, um daran zu arbeiten?

Die Antwort hängt davon ab, ob dein Repository nur ein Remote hat oder mehrere.

Vorbereitung: Aktuelle Branches vom Remote holen

Egal welcher Fall zutrifft, der erste Schritt ist immer derselbe:

git fetch

Damit lädt Git alle aktuellen Remote-Branches herunter Um zu sehen, welche Branches verfügbar sind:

git branch -v -a

Typische Ausgabe:

remotes/origin/test

Branches unter remotes/* sind nur lesbare Kopien der Remote-Branches. Um daran zu arbeiten, musst du daraus einen lokalen Branch erstellen.

Fall 1: Repository mit nur einem Remote

Wenn dein Projekt nur ein Remote hat (meist origin), ist Git recht komfortabel. Remote-Branch auschecken

git switch test

Was hier passiert:

  • Git erkennt automatisch origin/test
  • erstellt einen lokalen Branch test
  • setzt origin/test als Upstream

Diese automatische Zuordnung nennt sich Guessing und kann bei Bedarf mit –no-guess deaktiviert werden.

Fall 2: Repository mit mehreren Remotes

Gibt es mehrere Remotes, muss Git explizit wissen, von welchem Remote der Branch stammt.

Zuerst vom gewünschten Remote fetchen

git fetch origin

Dann lokalen Branch aus dem Remote-Branch erstellen

git switch -c test origin/test

Dabei bedeutet:

  • -c test → neuen lokalen Branch erstellen
  • origin/test → Quelle des Remote-Branches

Jetzt arbeitest du ganz normal auf dem lokalen Branch test, der mit origin/test verknüpft ist.

Anderes Thema: Unterschied zwischen git pull und git fetch

Eine Idee im Kopf?


Dann kontaktier mich doch


Wenn du Social-Media-Unterstützung brauchst oder ein Thema journalistisch sauber aufbereiten willst, melde dich.