So richten Sie einen Upstream-Zweig in Git ein

Um einen neuen Zweig zu pushen und seinen Upstream festzulegen, führen Sie `git push -u origin my-branch` aus. Wenn der Zweig bereits auf dem Remote vorhanden ist, führen Sie stattdessen git branch -u origin/my-branch aus. Danach wissen einfach git push und git pull, wohin sie gehen müssen. -u ist die Abkürzung für --set-upstream.

Was ist ein Upstream-Zweig in Git?

Der Upstream-Zweig, auch Tracking-Zweig genannt, ist der Remote-Zweig, der mit Ihrem lokalen Zweig verbunden ist. Git verwendet diesen Link für drei Dinge: wo git pull und git push ohne Argumente stehen, wofür das Vor- und Nachherzählen in git status im Vergleich zählt und was die Abkürzung @{u} bedeutet.

Wie stelle ich den Upstream für einen neuen Zweig ein?

git switch -c feature/search
git push -u origin feature/search

Dadurch wird der Zweig auf dem Remote erstellt und die beiden verknüpft. Sie benötigen nur -u beim ersten Push. Der Leitfaden zum Erstellen und Wechseln von Zweigen behandelt den Schritt davor.

Wie stelle ich den Upstream für einen vorhandenen Zweig ein?

Wenn der Remote-Zweig bereits vorhanden ist, verknüpfen Sie ihn, ohne ihn zu pushen:

# the branch you are on
git branch -u origin/feature/search

# any other branch
git branch -u origin/main main

Die Langform ist git branch --set-upstream-to=origin/main. Wenn Git sagt, dass der Remote-Zweig nicht existiert, führen Sie zuerst git fetch aus.

Wie behebe ich „Der aktuelle Zweig hat keinen Upstream-Zweig“?

Git gibt dies aus, wenn Sie git push auf einem Zweig ausführen, der noch nie gepusht wurde:

fatal: The current branch feature/search has no upstream branch.
To push the current branch and set the remote as upstream, use

    git push --set-upstream origin feature/search

Führen Sie den vorgeschlagenen Befehl aus. Damit der Fehler nicht mehr angezeigt wird, lassen Sie Git dies bei jedem ersten Push tun (Git 2.37 oder höher):

git config --global push.autoSetupRemote true

Die zugehörige Meldung „Für den aktuellen Zweig sind keine Tracking-Informationen vorhanden“ stammt von git pull. Der Fix ist derselbe: git branch -u origin/my-branch.

Wie sehe ich, was ein Zweig verfolgt?

# every branch, with its upstream and ahead/behind
git branch -vv

# only the current branch
git rev-parse --abbrev-ref @{u}

# commits you have not pushed
git log @{u}..

# commits you have not pulled
git log ..@{u}

Wie ändere oder entferne ich einen Upstream?

# point the branch somewhere else
git branch -u origin/develop

# stop tracking anything
git branch --unset-upstream

Keiner der Befehle ändert irgendwelche Commits. Sie bearbeiten nur die Einstellungen des Zweigs in .git/config.

Was bedeutet Upstream bei einer Abzweigung?

Das Wort hat eine zweite Bedeutung. Bei einem Fork ist upstream per Konvention der Name eines remote: des Originalprojekts, von dem Sie geforkt haben, während origin Ihre eigene Kopie ist. Darum geht es bei „git remote add upstream“:

git remote add upstream https://github.com/original/project.git
git fetch upstream
git switch main
git merge upstream/main
git push origin main

Weitere Informationen finden Sie unter Verfolgung festlegen und einen Zweig veröffentlichen und zum Üben in der Lektion zu Remotes und Upstreams.