PR Review 评论 — 跟进团队的代码审查讨论
Review 是什么
GitHub 上的 PR Review 是指被分配的 Reviewer 对代码改动发表意见。Review 评论通常有三种类型:
- Comment(普通评论):对某段代码或某个文件提意见,不阻塞合并
- Request Changes(请求修改):明确要求作者改某些地方,PR 不能合并直到改动被解决
- Approve(批准):Reviewer 认为 OK 了,可以合并
Gloom 里你能看到所有 Review 评论,但不能写自己的 Review。
Review 区在哪里
PR 详情页往下滚,在 PR 评论区的上方(或混在里面,取决于 PR 的活跃程度),能看到 Reviewer 的评论。Review 评论和普通 PR 评论在视觉上略有区别——Reviewer 的评论会带一个状态标签(Request Changes / Approve / Commented)。
Review 评论的特点
可以定位到具体代码行
Reviewer 的评论通常是挂在具体代码行上的(GitHub 网页版里 Reviewer 点某行代码,在该行下面留评论)。Gloom 把这些「行内评论」展示在 Diff 视图里对应的位置附近——让你看到评论针对的是哪段改动。
Review 线程
如果作者回应了 Review 评论,会形成一个线程(Review comment → Author reply → Reviewer follow-up...)。Gloom 会把同一线程的评论折叠在一起,展开后一条接一条显示。
多 Reviewer
一个 PR 可能被分配多个 Reviewer(比如项目维护者 + 代码 Owner)。Gloom 会按 Reviewer 头像区分各自的评论,方便你追踪谁在说什么。
怎么用 Review 区
读 Review 意见
- Request Changes:红色标签,Reviewer 明确要改什么。看完后可以在 Gloom 里记下要点,回电脑端写修复 PR
- Approve:绿色标签,Reviewer 通过了
- 普通 Comment:灰色标签,可能是建议性的,不阻塞合并
跟进活跃 PR
如果你是某个项目的贡献者,关注的 PR 有新的 Review 评论了怎么办?
- GitHub 官方 App 会推通知(Gloom 不推)
- 用 Gloom 打开该 PR 的 Review 区看最新评论
- 需要回应的话,切到网页版写回复
Review 区 vs 普通评论区的区别
| 维度 | Review 区 | 普通评论区 |
|---|---|---|
| 位置 | 通常在 Diff 附近,可挂到具体行 | PR 详情页下方,全文讨论 |
| 发起者 | 被分配的 Reviewer | 任何人(作者、其他贡献者、路人) |
| 能否阻塞合并 | Request Changes 会阻塞 | 不会 |
| 在 Gloom 里能看到 | ✅ | ✅ |
| 在 Gloom 里能写 | ❌ | ❌ |