Gloom 中文文档 下载 App

Pull Request 概览 — 改动提案的完整结构

Pull Request 是什么

Pull Request(PR)是向仓库提交代码改动的提案——某个开发者在自己的分支上改了代码,想把这些改动合入主分支,就会创建一个 PR。PR 里包含:改动了哪些文件、Diff 是什么样的、PR 作者写了什么说明、CI 测试过了吗、Reviewer 怎么说的。

PR 列表

在仓库页切到 Pull Requests Tab,看到所有 PR 的列表:

PR 详情页结构

点开某个 PR 后,从上到下:

  1. PR 标题
  2. 元信息条:PR 编号 · 作者 于 某时间 创建 · 状态(Open/Closed/Merged)· 合并目标分支
  3. PR 描述(Markdown 渲染,通常说明「改了什么、为什么改、有哪些破坏性变更」)
  4. CI 检查状态(如果仓库配置了 GitHub Actions,这里会展示各检查项的通过/失败状态)
  5. Reviewers 列表(谁被分配 Review 这个 PR,谁已经 Approve 了)
  6. Diff 摘要(改了多少文件、多少行增删)
  7. 评论区(按时间顺序的 PR 评论)
PR View
PR 详情 — 改动摘要 + Diff 视图

怎么判断一个 PR 能不能合并

Gloom 能告诉你 PR 的所有信息:

但 Gloom 不能替你合并——合并操作必须在 GitHub 网页版或官方 App 里完成。

改分支 vs 主分支的关系

PR 元信息里会显示:

base: main ← compare: user/feature-branch

意思是:PR 想把 user/feature-branch 这个分支的改动合进 main 分支。如果你不熟悉这个仓库的分支策略,可以在 Gloom 里把 base 和 compare 两个分支名都点开(能跳到对应分支的文件树),看看两个分支各是什么状态。

Draft PR

有些 PR 标着 Draft(草稿),意思是作者还在改,不希望现在 Review。Gloom 会在状态标识上区分 Draft PR,避免你误以为可以合并。