如何在 Git 中设置上游分支

要推送新分支并设置其上游，请运行 `git push -u origin my-branch`。 如果远程分支已存在，请改为运行 git branch -u origin/my-branch。之后，普通的 git push 和 git pull 就知道该去哪里。 -u 是 --set-upstream 的缩写。

Git 中的上游分支是什么？

上游也称为跟踪分支，是链接到本地分支的远程分支。 Git 使用该链接来做三件事：git pull 和 git push 不带参数的位置、git status 中前后计数的比较以及简写 @{u} 的含义。

如何设置新分支的上游？

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

这将在远程创建分支并链接两者。第一次推送时您只需要 -u。 创建和切换分支指南 涵盖了这一步之前的步骤。

如何为现有分支设置上游？

当远程分支已经存在时，链接它而不推送：

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

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

长形式是git branch --set-upstream-to=origin/main。如果 Git 提示远程分支不存在，请先运行 git fetch。

如何解决“当前分支没有上游分支”？

当您在从未推送过的分支上运行 git push 时，Git 会打印以下内容：

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

运行它建议的命令。要停止看到错误，请让 Git 在每次第一次推送时执行此操作（Git 2.37 或更高版本）：

git config --global push.autoSetupRemote true

相关消息“当前分支没有跟踪信息”来自git pull。修复方法相同：git branch -u origin/my-branch。

如何查看分支跟踪的内容？

# 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}

如何更改或删除上游？

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

# stop tracking anything
git branch --unset-upstream

这两个命令都不会更改任何提交。他们仅编辑 .git/config 中的分支设置。

分叉上的上游是什么意思？

这个词还有第二个含义。在分叉上​​，按照惯例，upstream 是 远程 的名称：您分叉的原始项目，而 origin 是您自己的副本。这就是“git远程添加上游”的含义：

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

请参阅设置跟踪并发布分支 了解详细信息，并参阅远程和上游课程 进行练习。