17. 本地代码评审

本节目标：学会用 /review 让 Codex 在提交前帮你检查改动，掌握评审面板的操作、行内评论反馈和 PR 评审流程。

为什么要让 Codex 评审代码

你写完一段代码，改了十几个文件，准备 git commit。这时候最怕什么？怕自己没注意到某个边界情况，怕改动引入了新 bug，怕提交了不该提交的东西。

Codex 的代码评审功能就是干这个的。它会在你提交或推送之前，检查你所有的改动，按优先级报告发现的问题。关键是—它只看不动，不会修改你的工作树。

用 /review 启动评审

在 Codex 输入框里输入：

/review

Codex 会问你选哪种评审方式：

Review uncommitted changes（评审未提交改动）：检查你当前还没 commit 的所有改动
Review against a base branch（与基线分支比较）：把当前分支和 main（或其他基线分支）做对比

Note

评审面板要求你的项目是一个 Git 仓库。如果项目还没用 Git，Codex 会提示你先初始化仓库。

评审范围：面板会显示哪些改动

评审面板反映的是 Git 仓库的状态，不只是 Codex 改过的内容。它同时包含 Codex 的改动、你自己的手改、以及仓库里的其他未提交改动。

默认显示 Unstaged（未暂存） 改动。你还可以切换到其他范围：

范围	含义	什么时候用
Unstaged	未暂存的改动（默认）	改完代码还没 `git add`
Staged	已暂存的改动（Git index 中）	已经 `git add` 但还没 `git commit`
Commit	某个选定提交的改动	想检查某个已经提交的 commit
Branch	当前分支与基线分支之间的差异	准备合并 PR 之前整体审一遍
Last turn	助手最近一轮会话产生的改动	刚让 Codex 改完东西，想看看它改了啥

Tip

评审范围选哪个，取决于你想检查什么。提交前整体检查选 Branch，只想看 Codex 刚改的选 Last turn。

评审结果：行内评论

评审跑完后，Codex 会把发现的问题以行内评论的形式标注在评审面板里。每条评论精确到具体的代码行，告诉你问题在哪、为什么有问题。

默认情况下，评审在当前聊天中运行。如果你觉得评审结果会干扰当前对话，可以改为独立评审模式：

打开 Settings > General > Code review
选择 Detached（分离）

这样评审会启动一个独立的聊天，不干扰你的主对话。

Note

如果你让 Codex 应用它发现的修复，正常的沙箱和审批设置仍然生效。它不会因为「这是修复评审问题」就绕过安全检查。

用行内评论给 Codex 反馈

行内评论是引导 Codex 修正问题最快的方式。与其打一大段文字描述问题在哪，不如直接在对应代码行上留评论。

操作步骤：

打开评审面板
把鼠标悬停到你想评论的那行代码上
点击出现的 + 按钮
写下你的反馈并提交
留完所有评论后，向聊天发送一条消息

Tip

发送后续消息时说清楚意图，比如：「Address the inline comments and keep the scope minimal.」（处理行内评论，尽量缩小改动范围。）Codex 会把你的行内评论当作评审指导，精准地逐条处理。

浏览评审面板

评审面板有几个实用操作：

点文件名：在你的编辑器中打开该文件
点文件名背景区域：展开或折叠该文件的 diff
按住 Command（Mac）/ Ctrl（Windows）点某一行：在编辑器中打开那一行
符合预期的改动：可以暂存它
不需要的改动：可以还原它

PR 评审：直接处理 Pull Request 反馈

如果你的项目在 PR 分支上，Codex 可以直接帮你处理 PR 上的评审者反馈。侧边栏会显示 PR 上下文和评审者评论，评审面板把评论和 diff 放在一起。

前提条件

需要安装 GitHub CLI 并完成认证：

# 安装 GitHub CLI（macOS）
brew install gh

# 认证登录
gh auth login

Warning

如果没装 gh 或没认证，侧边栏和评审面板不会显示 PR 详情。这是最常见的「PR 评审不出现」的原因。

暂存和还原文件

评审面板提供了 Git 操作，帮你在提交前整理 diff。操作可以在三个层级执行：

层级	操作	怎么用
Entire diff	整个 diff 的暂存 / 还原	评审标题栏的 Stage all 或 Revert all
Per file	按文件暂存 / 还原	在单个文件上操作
Per hunk	按变更块暂存 / 还原	在单个变更块上操作

用暂存来接受部分工作，用还原来丢弃不需要的改动。

Note

Git 允许同一个文件同时包含已暂存和未暂存的改动，所以评审面板可能会在两个视图中同时显示该文件。这是正常的 Git 行为，不是 bug。

小结

你想干啥	怎么做
启动评审	输入 `/review`，选评审范围
切换评审范围	在面板选 Unstaged / Staged / Commit / Branch / Last turn
给精准反馈	在代码行上留行内评论，再发消息让 Codex 处理
评审 PR	装 `gh` 并认证，在 PR 分支上打开评审面板
接受部分改动	按文件或按 hunk 暂存
丢弃不需要的改动	按文件或按 hunk 还原
独立评审模式	Settings > General > Code review > Detached

代码评审是提交前最后一道防线。/review 让 Codex 帮你过一遍改动，行内评论让你精准指导它修问题，评审面板的暂存和还原让你把 diff 整理得干干净净再提交。养成习惯：每次 commit 前先 /review 一下，比提交后发现 bug 再补救省事得多。

下一章讲 MCP 集成—怎么让 Codex 连接外部工具和服务，扩展它的能力边界。

本地代码评审

17. 本地代码评审

为什么要让 Codex 评审代码

用 /review 启动评审

评审范围：面板会显示哪些改动

评审结果：行内评论

用行内评论给 Codex 反馈

浏览评审面板

PR 评审：直接处理 Pull Request 反馈

前提条件

推荐 PR 评审流程

暂存和还原文件

小结