跳到主要内容

代码审查面板(Review Pane)

Review 面板让你可以在 Codex App 内直接审查、理解和迭代代码改动,无需切换到外部 Git 工具。

前提条件

Review 功能需要项目位于 Git 仓库中。没有版本控制的项目会提示初始化 Git。


查看范围

默认显示"未提交的改动",也可切换查看范围:

范围说明
未暂存/已暂存的改动当前本地工作内容
所有分支改动与基础分支的完整对比
最近一轮改动仅显示 Codex 上一轮操作的改动
提示

查看 Codex 做了什么时,使用"最近一轮改动"视图更聚焦,不受其他未提交内容干扰。

显示内容反映仓库真实状态,包括 Codex 的修改、手动编辑和其他未提交内容。


文件操作

操作方式
在编辑器中打开文件点击文件名
展开/折叠 Diff点击背景区域
在编辑器中打开特定行Cmd+点击行号
暂存已接受的改动点击 Stage 按钮
撤销不需要的改动点击 Revert 按钮

行内代码注释

直接在 Diff 的特定代码行上添加反馈:

  1. 将鼠标悬停在目标行
  2. 点击出现的 "+" 按钮
  3. 输入反馈内容并提交
  4. 发送后续指令,明确指出修改意图

注释会锚定到具体代码行,让 Codex 的响应比通用指令更精准。


自动化代码审查

在线程输入框中运行 /review 命令,Codex 会自动生成审查注释,直接显示在 Review 面板的对应代码行旁。


Git 操作粒度

Review 面板支持三个粒度的 Git 操作:

粒度说明
Diff 级别一次暂存/撤销所有改动
文件级别按文件单独管理
Hunk 级别按代码块(Hunk)精细控制
备注

部分暂存的文件(同时包含已暂存和未暂存改动)会分别显示在不同区域,与标准 Git 行为一致。