AI 说已经改完了,合并前怎么看 Diff?

0 阅读5分钟

一句话答案:Agent 回报「已完成」,只说明它停止了输出;能不能合进项目,要先打开实际 Diff,看清改了哪些文件、增删了多少行,再逐文件对照,而不是只看它的总结。

为什么不能只看 Agent 的「已完成」就合并?

直答:「已完成」是 Agent 自己的判断,总结里往往只写它计划改的位置;顺带改的配置、公共函数或无关文件,不一定会出现在回复里。

我自己就有过一次类似的教训。为了省事,我让 Agent 直接改一个小功能。它很快回复「已完成,验证通过」,我粗略看了眼回复就提交了。第二天发现它顺带改了几个与需求无关的文件,其中一处破坏了原有逻辑。Agent 并没有偷懒:需求做了,它也跑了自己认为必要的检查。问题是:我依据的是它的陈述,而不是实际产生的改动。

所以合并前要先回答三个问题:实际改了哪些文件?验证覆盖了什么、没覆盖什么?这些改动该不该进项目?前两个可以靠 Diff 看清楚,第三个只能由人来判断。

合并前怎么查看实际 Diff?

直答:任务显示「已完成」之后,先打开 git 菜单看未提交改动的汇总,再点「查看 Diff」,按文件清单和逐文件对照做验收,而不是先读总结。

我在 2026-11-11 实测了两次,都用 Grok(grok-4.7,推理强度 high)。

第一次任务是:「新建 hello.py,输出当前日期,并在 README 里说明用法」。任务显示已完成,上下文 6.7%,消耗 83.3K tokens。我打开任务标题旁的分支按钮(当时是 master +2),git 菜单顶部写着「2 处未提交改动:新增 1、修改 1、删除 0」。点「查看 Diff」后,顶部汇总是 2 文件,新增 1、修改 1、删除 0,+21 -0;左侧文件列表是 README.md +9、hello.py +12。这和需求范围对得上:一个新建文件、一个说明用法的修改,没有多出来的无关文件。

打开 README.md,能看到它补了一行 grok-4.7 的问候,以及一段用法(打印 ISO 日期,并给出 python3 hello.py)。打开 hello.py,是新建的 12 行:用 date.today().isoformat() 打印当天日期。左右对照下,新增行是绿色的。

第二次我接着让它「给 hello.py 加一个 --utc 参数,输出 UTC 日期」。完成后再打开 Diff,汇总变成 2 文件,新增 1、修改 1、删除 0,+31 -0(README.md +3,hello.py +24)。这次我在「左右」和「行内」之间切换:左右适合看改前改后整块对比,行内把同一文件的增删挤在一列里,看局部补丁更紧凑。顶部还可以切换「精简 / 全文」。

步骤可以记成:

  1. 任务变成「已完成」后,先别急着信总结;
  2. 打开 git 菜单,看「几处未提交改动」以及新增、修改、删除各多少;
  3. 点「查看 Diff」,先对文件清单:文件名和增删行数是否和需求一致;
  4. 再逐文件对照内容,用左右 / 行内、精简 / 全文切换;
  5. 看清楚之后,再决定提交、继续改,还是丢弃改动。

打开 Diff 后,先看文件清单和增删行数

有哪些实际好用的技巧?

直答:先看清单再看内容,范围对不上就停下来;小改用行内、大块用左右;看完再提交,不要在还没打开 Diff 时点「丢弃改动」。

  1. 先看文件清单和增删行数,再看总结。 需求只涉及一两个文件,清单里却多出好几个,就是超出范围的信号。第一次实测是 2 文件 +21 -0,和「新建 hello.py + 改 README」对得上,我才继续往下看。
  2. 逐文件看,不要只扫一眼总计。 README.md +9、hello.py +12 是两件不同的事,打开才能确认有没有顺带改无关内容。
  3. 左右 / 行内、精简 / 全文按场景切换。 看整段新增用左右更直观;看补丁细节用行内更省地方。精简突出变更行,全文保留上下文。
  4. 看完再决定提交或丢弃。 菜单里的「丢弃改动」对应 git reset --hard,会清掉未提交改动,点之前一定要先看过 Diff。

Diff 验收有什么做不到的?

直答:Diff 只能让你看清改了什么,不能替你下「可以交付」的结论,也不能代替跑测试。

  • 范围对、代码能跑,仍可能不符合你的意图或项目约定,这个判断只能人来做。
  • 「丢弃改动」是破坏性操作(git reset --hard),如果改动已经提交,菜单里的丢弃也救不回那次提交,需要自己用 Git 处理。
  • Agent 自报「验证通过」,只说明它执行过的检查通过了;没跑到的路径,Diff 也不会替你补测。
  • 工作台本身免费使用,支持 macOS / Windows / Linux;模型额度走你自己的 Agent 订阅或 API Key。

常见问答

  • 查看 Diff 会把改动提交掉吗? 不会。它只是打开对照,不会提交或推送。
  • 左右和行内有什么区别? 左右是改前改后并排;行内是同一列里看增删。我第二次实测切换过,小补丁用行内更紧凑。
  • 精简和全文有什么区别? 精简突出变更行,全文保留前后上下文,文件较长时先精简再按需切全文。
  • 文件很多时怎么快速判断有没有改超范围? 先看左侧清单里的文件名和每个文件的增删数,对不上就先不要合并,回到任务里追问为什么要改这些文件。
  • 看完 Diff 就可以直接推送吗? 先确认内容,再提交;推送是另一步(菜单里有「推送当前分支」)。

边界说明

Diff 验收解决的是「不要只凭 Agent 的『已完成』就合并」,不能代替选对任务范围、跑测试和代码评审。按钮名以你本机当前版本和手册为准。本文不写竞品对比。

遇到这个问题可以怎么用?

如果你已经在用本机 Claude Code / Codex / OpenCode / Grok 等 Agent,又希望在合并前先看清实际改动,也可以看一下 Caravel(免费使用,支持 macOS / Windows / Linux)。任务完成后打开 git 菜单,点「查看 Diff」,按文件清单和逐文件对照再决定是否提交。站点:www.caravelai.top/