第 3 章 · 审阅条与多文件改仓
本章目标:把 审阅条 练成本能——逐文件看 diff、✓ 接受 / ✗ 拒绝、理解 全部保留 的风险;掌握 多文件改仓 的范围控制与 Git 安全网;知道审阅条没有什么功能(避免找错按钮)。
学时建议:3~3.5 小时(含 1.5 小时跟练)
前置:srx-v7 ch01~ch02(会发 SRX 任务);git-collab ch03(暂存提交)建议已读。
3.1 场景说明:一次 SRX 改了 8 个文件,你点错了
Leader 的原话:
「SRX 可以快,但落盘是你的签字。审阅条不是形式主义——点全部保留之前,每个文件至少扫一眼。」
本章用 单文件 → 多文件 → 故意拒绝 三次跟练,让你建立「拒绝比接受更安全」的肌肉记忆。
3.2 学完你能
| 能力 | 验收 |
|---|---|
| 审阅流程 | 等审阅条 → 点文件名 → 看 diff → ✓/✗ |
| 快捷键 | 预览里 Ctrl+Enter 接受、Esc 取消 |
| 多文件 | 任务写清范围;单次建议 ≤6 文件 |
| Git 网 | 改前 status clean 或已 commit |
| 边界 | 知无「全部拒绝」、无 hunk 编辑按钮 |
| 纪律 | 不盲点「全部保留」 |
3.3 审阅条是什么、为什么存在
SRX 改完代码后,不会直接静默写盘。改动先进入 审阅条(执行面板底部区域),等您确认后才落盘。
SRX 生成改动 → 审阅条(待确认) → 您 ✓ → 写入磁盘
→ 您 ✗ → 丢弃该文件改动
这是 SRX 的质量闸门——相当于代码负责人 Review 通过才 merge(对照 git-collab ch09 PR Review,审阅条是本地第一道关)。
发送任务后常见提示:SRX 任务已发送,请关注审阅条。
3.4 审阅条界面说明
| 元素 | 含义 |
|---|---|
| 标题 N 个文件 | 本次共改几个文件(超过 4 个可能默认折叠,可展开) |
| 文件名列表 | 点击打开 diff / 行内预览 |
| ✓ | 接受该文件改动(落盘) |
| ✗ | 拒绝该文件改动(丢弃) |
| 全部保留 | 批量接受当前待确认改动 |
| Review | 有待预览时出现,进入审阅流程 |
通知区常见文案:
- 审阅 · 已落盘 / 已接受 / 已拒绝 / 已接受全部待确认改动
3.5 逐步审阅(推荐流程,逐步跟练)
步骤 1 — 等待
- SRX 执行结束,审阅条出现
- 先看 几个文件——若超出预期,优先 ✗ Whole files 或 停止 后重写任务范围
步骤 2 — 逐个打开
- 点击文件名
- 主编辑器显示 红/绿行内 diff
预览提示常类似:
请在主编辑器查看红/绿行内差异并确认(Ctrl+Enter 接受 · Esc 取消)
步骤 3 — 单文件决策
| 判断 | 操作 |
|---|---|
| 改动正确 | 审阅条 ✓,或预览 Ctrl+Enter |
| 改动不对 | 审阅条 ✗,或预览 Esc |
| 大体对、差一行 | 可先 ✓ 再手工改;或 ✗ 后让 SRX 重做(更干净) |
步骤 4 — 全部看完再考虑「全部保留」
- 仅当每个文件都已看过且都 OK
- 新手建议:永远不用全部保留,习惯逐文件 ✓
步骤 5 — 落盘后
- Ctrl+S(若未自动保存)
- Git 暂存 → 提交(git-collab ch03)
- 运行任务里写的 验收(测试、curl、页面点一遍)
3.6 跟练 A:单文件 ✓ 与 ✗(必做)
- 打开小项目(ch01 仓库根)
- SRX 任务:
【目标】给 README.md 加一行:「ch03 审阅练习 A」
【范围】仅 README.md
- 审阅条应 1 个文件
- 第一次:故意点 ✗ 拒绝 → 打开 README,应无新行
- 再发同样任务 → ✓ 接受 → 应有新行
你应该看到:拒绝 = 磁盘不变;接受 = 内容写入。
3.7 跟练 B:多文件 + 范围控制(必做)
步骤 1 — Git 干净(ch09 绝学 1)
git status # clean 或先 commit
git checkout -b try/ch03-review
步骤 2 — 任务(控制 2~3 文件)
【目标】README 增加「模块说明」小节;docs/guide.md 增加一行链接回 README
【范围】只改 README.md 和 docs/guide.md(若 guide 不存在可新建)