GitHub Desktop 怎么为分支设置 upstream 远程

在 GitHub Desktop 里说“给分支设置 upstream”，常常混合了两个概念：fork 工作流中的父仓库关系，以及本地分支发布后跟踪的远程分支。实际操作时，先在 Repository > Repository settings... > Fork Behavior 里选择向父仓库贡献，再在 Current Branch 中发布当前分支。首次发布成功后，顶部按钮会从 Publish branch 变成 Push origin。

GitHub Desktop 不提供给任意远程随意命名、手动绑定的“upstream”输入框。fork 协作关系用 Fork Behavior 表达；当前分支的远程跟踪则通常通过 Publish branch 建立，并由 Push origin 继续推送。

先分清：upstream 是父仓库关系还是分支跟踪

如果你从别人的仓库创建了 fork，upstream 通常指原始父仓库；你的 fork 则是 origin。GitHub Desktop 的 Fork Behavior 设置用于告诉它：这个 fork 是为了向父仓库贡献，还是只作为自己的独立副本。

另一个语境是 Git 的分支跟踪关系。一个本地分支发布到 GitHub 后，Desktop 会把后续动作显示为 Push origin。这个按钮说明当前分支已经有可用的远程推送目标，但它不等于你在界面里创建了一个名字叫 upstream 的新 remote。

步骤一：确认仓库和要发布的分支

打开 GitHub Desktop 后，先看顶部的 Current repository，确认不是同名仓库的另一个本地副本。接着点击 Current Branch，选中要协作的功能分支，例如 feature/docs-sync。

如果左侧 Changes 仍有未提交文件，先在当前分支提交，或者使用 GitHub Desktop 的 Stash All Changes 暂存。这样做是为了避免切换分支时把工作区修改带到错误的分支，并不是设置 upstream 的必需条件。

步骤二：在 Fork Behavior 中设置父仓库协作

如果当前仓库是 fork，打开顶部菜单 Repository，点击 Repository settings...。在设置窗口左侧选择 Fork Behavior，然后选中 To contribute to the parent repository，点击保存。

这个设置表达的是协作方向：当前 fork 的工作最终要回到父仓库。它不是把某个 URL 填入名为 upstream 的输入框，也不会替代分支发布。若当前仓库不是 fork，页面可能没有可用的父仓库关系，此时只需要继续管理本地分支和 origin。

步骤三：发布分支并确认 Push origin

回到主窗口，点击 Current Branch，再次选中功能分支。如果它还没有出现在远程，仓库工具栏会显示 Publish branch，点击后等待发布完成。GitHub 官方文档把这一步定义为让新建分支在 GitHub 上可供协作。

发布完成后，按钮通常变为 Push origin。这就是最直接的可见确认：当前分支已经有了远程推送路径。之后你在本地提交，点击 Push origin，就会把这些提交推到显示的 origin 远程；如果远程有更新，Desktop 可能先提示 Fetch，再继续同步。

常见问题：为什么找不到 upstream 输入框

GitHub Desktop 能不能把任意远程命名为 upstream？

不能把它当成通用的 remote 管理器。Desktop 通过 Fork Behavior 管理 fork 父仓库关系，并用 Publish branch/Push origin 完成常见发布流程。需要添加或重命名任意 remote 时，应在仓库命令行中用 git remote -v 核对，再回到 Desktop 继续可视化提交。

点击 Publish branch 后为什么不是 upstream？

因为 Publish branch 的常见目标是当前账户可写的 origin。upstream 在 fork 语境中通常是父仓库，不是“第一次推送后自动出现的按钮名称”。不要仅凭按钮文字判断父仓库关系。

怎样确认分支真的发布成功？

看顶部是否从 Publish branch 变为 Push origin，再打开 Current Branch 检查该分支是否出现在远程分支列表。若推送被拒绝，还要检查仓库写权限、分支保护规则和远程是否有尚未拉取的提交。

最后再复述一次边界：Fork Behavior 解决“这个 fork 要不要向父仓库贡献”，Publish branch 解决“当前本地分支是否发布到远程”，Push origin 解决“后续提交推到哪里”。把这三件事分开检查，就不会为了寻找一个不存在的 upstream 输入框而反复改设置。