Skip to content

在 Codex 应用中审查代码变更、查看差异、添加行内评论以及管理 PR 审查

检查差异、处理 PR 反馈、暂存文件、提交和推送

审查页面是 Codex 应用中用于查看和管理代码变更的核心界面。你可以在这里检查 Codex 所做的所有更改、逐行审查差异、添加行内评论,以及暂存或回退特定的修改。

审查页面会展示当前线程中所有已修改、新增和删除的文件。每个文件旁边会显示变更统计信息——例如添加和删除的行数。你可以点击任意文件来展开其完整差异视图。

审查页面概览

变更按以下类别进行分组:

  • 已暂存(Staged):已标记为准备提交的变更
  • 未暂存(Unstaged):尚未标记的变更
  • 未跟踪文件(Untracked):尚未被 Git 跟踪的新文件

Codex 提供了多种方式来浏览和定位代码变更:

  • 文件列表导航:在左侧文件列表中点击文件即可跳转到该文件的差异视图
  • 差异内跳转:在差异视图中,可以使用键盘或鼠标滚动浏览每个变更块(hunk)
  • 跳转到源文件:点击文件名或使用「在编辑器中打开」可在你的 IDE 中直接打开对应的源文件
  • 搜索过滤:当变更文件较多时,可以使用搜索框按文件名快速筛选

你可以在差异视图的任意行上添加行内评论(inline comments)。这对于标记需要注意的代码片段、提出问题或给出反馈非常有用。

要添加行内评论:

  1. 在差异视图中,将鼠标悬停在目标代码行上
  2. 点击出现的 + 按钮
  3. 输入你的评论内容
  4. 按 Enter 或点击提交

Codex 也可以生成行内评论。当 Codex 在审查模式下运行时,它会使用 ::code-comment{...} 指令来标记发现的问题,包括优先级、置信度和具体的代码位置。

代码审查结果(Code Review Results)

Section titled “代码审查结果(Code Review Results)”

当 Codex 完成代码审查后,审查结果会展示在审查页面中。结果包括:

  • 发现的问题:按优先级(P0–P3)和置信度分类
  • 整体评估:对代码变更质量的总体判断
  • 具体建议:针对每个发现问题的改进建议
  • 文件级摘要:每个受影响文件的审查摘要

你可以逐条确认、驳回或要求 Codex 对具体问题进行更深入的分析。

审查页面与 GitHub Pull Request 深度集成:

  • 查看 PR 详情:输入 PR 编号即可拉取该 PR 的完整信息、差异和评论线程
  • 对比基准分支:Codex 可以自动检测当前分支和基准分支之间的所有差异
  • PR 检查状态:查看该 PR 的 CI 检查状态、审查状态和合并冲突情况
  • 回复审查评论:直接在审查页面中回复 GitHub 上的审查评论
  • 更新现有 PR:Codex 可以根据审查反馈自动更新 PR 中的代码

你也可以在 GitHub PR 评论中通过 @codex review 来触发 Codex 对该 PR 的自动审查。

审查页面提供了灵活的暂存和回退功能,让你可以精确控制哪些变更被提交:

  • 暂存单个文件:点击文件名旁的复选框即可暂存该文件的所有变更
  • 暂存部分变更(Hunk):在差异视图中,可以只暂存特定的变更块
  • 暂存特定行:选中差异视图中的特定代码行进行暂存
  • 全部暂存:使用「暂存全部」按钮一次性暂存所有变更
  • 回退未暂存的变更:将文件恢复到修改前的状态
  • 回退已暂存的变更:先从暂存区移除,再进行回退
  • 只回退特定变更块:在差异视图中可以只回退选中的变更块
  • 清理未跟踪文件:删除未被 Git 跟踪的新文件

完成审查和暂存后,你可以:

  1. 输入提交信息
  2. 选择提交范围(仅已暂存的变更或所有变更)
  3. 选择是否在提交后推送到远程仓库

Codex 也可以根据变更内容自动生成提交信息。

-
0:000:00