AI Agent / 系统课时

审查文件差异

审查文件差异

Codex 完成修改后,真正决定代码能否进入仓库的是审查阶段。本课把桌面应用的 Review 面板当作工作入口:先确认差异范围,再逐文件、逐块阅读,利用内联评论要求修正,最后只暂存认可的内容并撤销不需要的修改。

学习目标

  • 区分 Unstaged、Staged、Commit、Branch 与 Last turn 等差异范围
  • 能从修改摘要进入逐文件、逐块审查,并用 Git 命令交叉验证
  • 能用内联评论、暂存和撤销完成“接受、调整或丢弃”的闭环

先确认你正在审查什么

当前桌面版的 Review 面板读取的是 Git 仓库状态,而不只是 Codex 刚刚生成的代码。因此,同一个面板里可能同时出现 Codex 修改、你手工编辑的内容以及其他尚未提交的改动。审查前先选对范围,否则很容易把“本轮代理修改”和“仓库里原本就存在的修改”混在一起。

常用范围有:Unstaged 查看工作区未暂存修改,Staged 查看索引区,Commit 查看某次提交,Branch 查看当前分支相对基线分支的差异,Last turn 则聚焦最近一次助手回合产生的改动。要让 Codex 做一次独立代码审查,可在输入框使用 /review,再选择基于分支或未提交修改的审查范围;审查器会报告发现,而不会因为“审查”本身修改工作树。

从摘要进入逐文件差异

先看修改摘要判断范围是否符合任务:哪些文件被改动、增加和删除了多少行、有没有出现意料之外的目录。然后展开文件,重点阅读每个 hunk 的上下文,而不是只看绿色新增行。删除的校验、异常处理或边界判断,往往比新增代码更值得警惕。

Review 面板展示的是 Git 差异,因此可以用命令行做一次独立核对。下面的命令分别检查工作区状态、未暂存修改摘要和已暂存修改摘要:

bash
git status --short
git diff --stat
git diff --cached --stat

预期输出

text
 M <PATH>
<PATH> | <N> +++---
<N> file(s) changed, <N> insertion(s)(+), <N> deletion(s)(-)
<PATH> | <N> ++--
<N> file(s) changed, <N> insertion(s)(+), <N> deletion(s)(-)

<PATH> 与 <N> 会随仓库实际修改而变化;若某个范围没有修改,对应的 git diff 命令可能不输出内容。若 Review 面板显示“已暂存”,而 git diff --cached --stat 为空,就应该先确认当前选中的仓库和审查范围,而不是继续依据错误视图做决定。

用内联评论要求精准调整

发现问题时,不必把文件名、函数名和行号重新描述一遍。打开 Review 面板,在目标行添加内联评论,再发送一条明确的后续指令,例如要求“处理这些内联评论,并保持改动范围最小”。行级反馈会把意见绑定到具体上下文,适合指出错误条件、命名问题、遗漏测试或不必要的重构。

如果问题不是某一行,而是整体设计偏离目标,可以在聊天中补充约束后让 Codex 继续修改。修改完成后重新看 Last turn,确认本轮只触碰了预期位置;再切回 Unstaged 或 Branch,确认整个工作区没有遗留的非预期改动。

接受、调整或撤销

Review 面板可以按整个差异、单个文件或单个 hunk 执行暂存、取消暂存和撤销。暂存只是把认可的修改放进 Git 索引区,不等于已经提交;撤销则会丢弃对应的本地改动。 对不确定的代码,先评论并要求调整,比直接 Revert 更容易保留有价值的部分。

一个可靠的闭环是:先选准差异范围,再看修改摘要,逐文件检查上下文,对问题行留下内联评论,让 Codex 修正后重新审查,最后只暂存通过的 hunk。提交前再运行项目自己的测试、lint 或类型检查,确保“diff 看起来合理”和“代码实际可用”同时成立。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

审查文件差异

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通