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