跳到主要内容

关于拉取请求

Pull请求允许您告诉其他人您已将更改推送到GitHub上存储库中的分支。打开拉取请求后,您可以与合作者讨论和审查潜在的更改,并在将更改合并到基本分支之前添加后续提交。

关于拉取请求

拉请求是将一组更改从一个分支合并到另一个分支的建议。在pull请求中,合作者可以在将更改集成到主代码库之前审查和讨论所建议的更改集。Pull请求显示源分支中的内容和目标分支中内容之间的差异。

注:处理拉取请求时,请记住以下几点:

  • 如果你在共享存储库模型,我们建议您对拉取请求使用主题分支。虽然您可以从任何分支或提交发送拉取请求,但使用主题分支,如果需要更新建议的更改,您可以推送后续提交。
  • 当强制推送提交到拉请求时要非常小心。强制推送会更改存储库历史记录,并可能破坏您的拉取请求。如果其他合作者在强制推送之前分支项目,则强制推送可能会覆盖合作者基于其工作的提交。

您可以在GitHub.com上、使用GitHub桌面、在GitHub代码空间中、在Git Hub Mobile上以及在使用GitHb CLI时创建拉请求。

初始化拉请求后,您将看到一个审查页面,其中显示了分支(比较分支)和存储库基本分支之间的更改的高级概述。您可以添加建议更改的摘要,查看提交所做的更改,添加标签、里程碑和受让人,以及@提及各个贡献者或团队。有关详细信息,请参阅“创建拉取请求."

创建拉请求后,可以从主题分支推送提交以将其添加到现有的拉请求中。这些提交将在您的请求中按时间顺序显示,更改将显示在“文件更改”选项卡中。

其他贡献者可以审查您提议的更改,添加审查注释,为拉请求讨论做出贡献,甚至向拉请求添加提交。默认情况下,在公共存储库中,任何用户都可以提交审核或请求对拉入请求进行更改的评论。组织所有者和存储库管理员可以限制谁能够提供批准的请求审阅或请求更改。有关详细信息,请参阅“管理组织中的拉入请求审核“和”管理存储库中的请求审阅."

您可以在“对话”选项卡上查看有关分支当前部署状态和过去部署活动的信息。有关更多信息,请参阅查看存储库的部署活动."

对提议的更改感到满意后,可以合并拉请求。如果您在共享存储库模型中工作,您将创建一个请求,然后您或其他人将把您的功能分支中的更改合并到您在请求中指定的基本分支中。有关详细信息,请参阅“合并拉取请求."

如果存储库需要进行状态检查,则必须通过所需的状态检查,然后才能将分支合并到受保护的分支中。有关详细信息,请参阅“关于受保护的分支."

您可以将请求链接到问题,以显示正在进行修复,并在有人合并请求时自动关闭问题。有关详细信息,请参阅“将拉取请求链接到问题."

提示:

  • 要在拉入请求中折叠和扩展所有过时的审阅注释之间切换,请按住选项中高音中高音然后单击显示过期的隐藏过期的。有关更多快捷方式,请参阅“键盘快捷键."
  • 您可以在合并pull请求时挤压提交,以获得更精简的更改视图。有关详细信息,请参阅“关于拉请求合并."

您可以访问仪表板,快速找到您正在处理或订阅的最近更新的拉取请求的链接。有关详细信息,请参阅“关于您的个人仪表板."

起草拉取请求

在GitHub Free的公共存储库中,可以为组织和传统的预存储计费计划提供拉取请求草稿,在GitHub Team、GitHup Enterprise Server和GitHum Enterprise Cloud的公共和私有存储库中也可以提供拉取申请草稿。有关详细信息,请参阅“GitHub的计划."

创建拉取请求时,您可以选择创建准备好进行审阅的拉取请求或草稿拉取请求。无法合并草稿请求,并且不会自动请求代码所有者审阅草稿请求。有关创建草稿请求的更多信息,请参阅“创建拉取请求“和”从fork创建pull请求."

当您准备好获得关于提取请求的反馈时,您可以将提取请求草稿标记为准备好进行审查。将拉请求标记为准备好进行审阅将请求任何代码所有者进行审阅。您可以随时将拉取请求转换为草稿。有关详细信息,请参阅“更改拉取请求的阶段."

比较请求页和拉请求页上提交之间的差异

比较和拉取请求页面使用不同的方法计算更改文件的差异:

  • 比较页面显示头引用的尖端与头引用和基引用的当前公共祖先(即合并基)之间的差异。
  • Pull请求页面显示创建Pull请求时head-ref的尖端与head和base-ref的公共祖先之间的差异。因此,用于比较的合并基数可能不同。

进一步阅读