~/VibeHandbook
$39

10 · 05

带着批判地阅读 diff

diff 就是一份关于究竟改了什么的清单:红色行被删除,绿色行被新增。读 diff 是 vibe coding 中杠杆率最高的习惯,因为正是在这里你能抓出 AI 在做你没要求它做的事。

你不必理解每一行。扫一扫这些危险信号:

  • 你没料到会变的文件。 一个配置文件为什么被改动了?
  • 被删掉的代码。 它是不是为了"让测试通过"而删掉了一个校验检查、一个错误处理器,或一个测试?
  • 密钥或硬编码的值。 不该出现在代码里的 API key、密码或 URL。
  • 被禁用的检查。 一个被跳过的测试、一段被注释掉的守卫、一个 // @ts-ignore,或者一个被放松的权限。
  • 范围蔓延(Scope creep)。 离你要求的内容很远的改动。

如果有什么看起来不对劲,就问:"解释一下你为什么改了 X——我没要求改那个。" 尤其要让 AI 为删除行为辩护。"它在导致报错"是一个去理解那个报错的理由,而不是删掉那个检查的理由。

一个养成习惯的实用做法:在你接受改动之前读 diff,绝不在之后。一旦代码被合并、应用看起来能跑,你就再也不会回去读它了——没有任何摩擦逼着你去读。审查的那一刻,必须就是决定的那一刻。工具在这里帮得上忙:git diff --stat 给你每个文件一行的摘要,让意料之外的文件立刻跳出来;在 pull request 页面上审查,会把整个改动呈现在一个可滚动的视图里,而不是散落在你编辑器各处。

想离线阅读?

获取 PDF + EPUB + 可下载的提示词库 + 版本更新。

$ 获取 PDF — $39