查看 Git Diff

精确查看 AI 智能体改了什么——逐文件、逐行对比。

在提交 AI 智能体写的任何代码之前,先看一遍 diff。这只需要 30 秒,却能避免你把有问题或意料之外的改动提交出去。Git Client 以清晰、带颜色标记的方式展示每一处改动,让这件事变得很轻松。

打开 Diff 视图

  1. 按 Cmd+G(Mac)或 Ctrl+G(Windows/Linux)打开 Git 面板
  2. 左侧边栏会列出所有存在未提交更改的文件——未暂存的更改显示在下方区域
  3. 点击任意文件名,即可在右侧打开它的 diff

Diff 视图会立即打开,无需任何额外步骤。

Git 可视化更改 diff 视图

阅读 Diff

Diff 使用标准的颜色标记:

  • 绿色行——智能体新增的行
  • 红色行——被删除或被替换的行
  • 灰色行——改动周围未变化的上下文(仅供参考)

每一段改动称为一个 hunk。如果文件的不同位置都有改动,一个文件可以包含多个 hunk。向下滚动即可查看全部。

左侧的行号是原文件的行号,右侧的行号是新文件的行号。

从 Diff 跳转到代码

双击即可在编辑器中打开某处改动:

  • 已更改的文件——无论是在文件列表、文件夹树、某次提交的文件列表中,还是在 diff 标题栏的文件名上——都会在编辑器中打开该文件。
  • diff 中的某一行会打开对应文件,并将光标定位到那一行。新增行和未变化的行会定位到它们自己所在的行,被删除的行会定位到现在占据其位置的那一行,hunk 标题则定位到该 hunk 的第一行。

统一视图与并排视图

你可以在两种 diff 布局之间切换:

  • 统一视图——新增与删除的内容交错显示在同一列中,更适合按顺序阅读改动。
  • 并排视图——旧文件在左,新文件在右,当大段内容发生变化时,更便于对比修改前后的差异。

点击 diff 面板右上角的视图切换按钮即可在两者之间切换。

Diff 查看器

图片 Diff

如果你的项目包含图片,而智能体修改了 PNG、JPG 或其他图片文件,diff 面板会显示修改前后的可视化对比。你可以拖动滑块,在新图片下方露出旧图片——非常适合发现无意间产生的设计变动。

键盘导航

使用以下快捷键可以在已更改的文件之间快速切换:

快捷键操作
]跳到下一个已更改的文件
[跳到上一个已更改的文件
↓ / ↑滚动浏览 diff

用 ] 和 [ 在文件之间切换,比在侧边栏里逐个点击快得多,尤其是当智能体一次改动了十几个文件时。

为什么要在提交前审查?

AI 智能体工作很快,而且通常是对的——但并非总是如此。审查 diff 时,常见需要留意的情况有:

  • 不该被删除的行被删了——智能体可能误删了某个函数或某段注释
  • 出现了你没要求改动的文件——智能体动了你没预料到的配置文件或测试文件
  • 占位符内容——TODO、your-api-key-here,或本不该保留的硬编码测试数据

每次提交前快速审查一遍 diff,可以让你的 Git 历史保持干净,让代码库始终处于已知良好的状态。它还能帮你理解智能体到底做了什么,久而久之让你成为更优秀的开发者。