拉取请求(pull request,简称 PR)提出将一个分支的改动合并到另一个分支。Git 负责记录提交和分支,托管服务则围绕这些改动提供审查页面、讨论和检查结果。
Git · 第 7 课
拉取请求
学习如何阅读拉取请求,并确认代码审查或自动检查覆盖了哪些改动。
找出源分支和目标分支
假设同事提议为网站增加状态页。审查页显示 health-page → main。源分支有时叫 head,它提供拟合并的改动。目标分支有时叫 base,它负责接收这些改动。
Source: health-page at 3ab4501
Target: main
Changed file: health.txt
此时,审查页描述的是待合并的改动。等 PR 合并后,目标分支才会接收改动。
合并这个 PR 后,哪个分支会收到状态页?
查看改动
打开变更文件视图,查看相对于 PR 目标分支的差异。health.txt 增加一行,符合新增一个简单状态页的预期。如果审查页还显示 index.html 有改动,就要核对该改动是否也应纳入这次 PR。应以页面上实际列出的文件为准。
标题叫 Add a health page 的 PR 还改了主页。到哪里可以核对具体改了什么?
查看自动检查结果
PR 发生变化时,托管平台可以自动运行测试。找到这次结果所覆盖的提交或修订版本。如果测试通过之后又推送了一次提交,应确认更新后的版本也执行了所需检查。通过的结果只适用于实际执行过的检查。
有一项测试在 3ab4501 上通过了,而 PR 现在指向 78ac900。采信这个结果之前,应该确认什么?
课程已完成
你已完成 拉取请求
现在,你可以读懂 PR 提出了什么改动,以及哪些依据支持合并。
找出源分支和目标分支。
在变更文件视图中核对拟议改动。
确认自动检查结果对应哪个版本。