拉取请求是将代码更改合并到项目中的建议。 拉取请求是 GitHub 的基本协作功能,让你可以在合并更改之前讨论和审查更改。 这有助于团队协同工作、提前捕获问题并维护代码质量。
查看拉取请求处理拉取请求
拉取请求的 “对话” 选项卡显示更改的描述、事件时间线以及协作者的评论和审核。 通过此中心,可以跟踪提议的更改的讨论进展情况。
“ 提交 ”选项卡按时间顺序显示对拉取请求分支所做的所有提交。 这有助于了解开发历史记录,并了解随时间变化的变化。
“ 检查 ”选项卡显示推送提交时运行的任何自动测试、生成或其他持续集成工作流的状态。 这些检查有助于在合并之前确保更改符合质量标准。
“ 文件更改 ”选项卡显示建议的更改与现有代码之间的差异,使得在拉取请求合并时可以轻松查看更改的内容。
可以直接在拉取请求页面任何位置的标头中查看拉取请求的合并状态。 单击可打开详细信息,以便快速识别阻碍因素、缺失的审批,并使拉取请求准备好合并。
草稿拉取请求
创建拉取请求时,可以选择将其设为草稿拉取请求。 无法合并草稿拉取请求,并且不会自动请求代码所有者审阅它们。 如果要在不正式请求评审的情况下共享正在进行的工作,这非常有用。
准备获取对拉取请求的反馈时,可将拉取请求草稿标记为可供审查。 将拉取请求标记为可供审查将要求任何代码所有者进行审查。 可以随时将拉取请求转换为草稿。 请参阅“更改拉取请求的阶段”。
拉取请求引用和合并分支
打开拉取请求时, GitHub 会为其创建最多两个临时只读 Git 引用:
| 引用 | 说明 |
|---|---|
refs/pull/PULL_REQUEST_NUMBER/head | 指向拉取请求头分支上的最新提交。 |
refs/pull/PULL_REQUEST_NUMBER/merge | 一个合并分支,这是一个模拟的合并提交,表示如果现在合并拉取请求,存储库将呈现的状态。 仅当拉取请求没有合并冲突时,此 ref 才可用。 |
当头分支或基分支发生更改时,合并分支会自动更新。 在本地提取它:
git fetch origin refs/pull/PULL_REQUEST_NUMBER/merge
git checkout FETCH_HEAD
将 PULL_REQUEST_NUMBER 替换为你的拉取请求编号。
有关GitHub Actions使用合并分支的信息,请参阅触发工作流的事件。
比较页和拉取请求页上的提交之间的差异
比较页和拉取请求页使用不同的方法来计算已更改文件的差异:
- 比较页显示头部引用的提示与头部及基础引用当前的共同上层节点(即合并基础)之间的差异。
- 拉请求页面显示在创建拉取请求时头部引用头与头部和基础的共同上层节点之间的差异。 因此,用于比较的合并基可能有所不同。