SPT术语库

合并请求 Pull Request

功能分支已经完成,你要让同事先看差异、跑检查并决定是否合入 main。

Git约 10 分钟 · 从真实需求理解

1Pull Request 请求的是什么?

GIT · REVIEW REQUEST先审查,再决定是否合入

HEAD → PULL REQUEST → CHECKS,Pull Request 让团队看清改动再决定下一步。

01 · HEAD BRANCHfeature/save-buttonc21f7ab2 commits ahead
BASE BRANCHmaind4e8b11target branch
PULL REQUEST #42OPEN
Add SaveButton feedback

2 files changed · reviewable diff

+SaveButton.vue+spec.ts
READY TO MERGEfeature/save-button → mainreview in progress

Pull Request 是把一个分支的改动公开给团队,请大家先查看差异、运行检查并给出意见,再决定是否把它合入目标分支。它是协作平台上的审查请求,不等于已经完成 Merge。

  • head 分支说明改动来自哪里,base 分支说明准备进入哪里。
  • 请求里应该能看到文件差异、自动检查和评审状态。
  • READY TO MERGE 只说明满足当前门槛,真正合入仍是后续动作。

2Pull Request 不等于 Merge、Push 或 Issue

Push 把提交送到远程,Pull Request 再把这些提交包装成一个可审查、可讨论的合入请求。Merge 才是把两条历史真正汇合成 Git 记录的动作。

  • Pull Request 可以等待评审、修改和检查,未必会被合入。
  • Issue 主要记录问题或任务;Pull Request 带着具体代码差异和目标分支。

看到 READY TO MERGE 不代表线上已经更新;合入、部署和发布仍然是后续不同边界。

3一次 Pull Request 由哪些部件组成?

HEAD → BASEfeature/save-button → mainc21f7ab → d4e8b11
REQUEST · PR #42Add SaveButton feedbackreviewable change set
DIFF+ SaveButton.vue+ spec.ts · 2 files changed
CHECKSCI PASS · REVIEW APPROVEDREADY TO MERGE

Pull Request 提供审查证据和合入请求;它本身还没有把历史合成新的 Merge Commit。

把 Pull Request 拆开看,head 和 base 定义改动方向,请求卡承载标题和讨论,diff 说明具体变化,checks 与 review 则决定当前是否满足合入门槛。

  • BRANCHES 是来源 head 和目标 base 的关系。
  • REQUEST 是可讨论、可更新和可审查的 Pull Request 对象。
  • DIFF 是团队真正要查看的文件变化。
  • CHECKS 是自动检查和人工评审共同形成的合入门槛。

4怎样把 Pull Request 需求交给 Agent?

请为 feature/save-button 创建一个指向 main 的 Pull Request,标题是 Add SaveButton feedback;展示 SaveButton.vue 和 spec.ts 的 diff,等待 CI PASS 与 REVIEW APPROVED 后标记 READY TO MERGE,但不要直接执行 Merge 或部署。请把 Pull Request、Merge、Push、Issue、普通评论和发布区分开,支持共享重播、Anatomy 键盘操作、暗色主题和 390px、320px 窄屏。

5不用背,看看你能不能判断

1 / 3

Pull Request 最主要解决什么问题?

请选择一个最符合题意的答案

选择答案后自动进入下一题

社区延伸

看别人真实遇到过什么

社区帖子还没有关联到这个词条。