Codex App 故障排查：为什么侧边栏出现不是 Codex 改的文件

适用场景

这篇手册适合遇到这种情况的用户：你让 Codex 改了一个小地方，但 Codex App 侧边栏却出现了一堆文件，看起来像 Codex 改了很多内容。

OpenAI 官方故障排查文档说明，如果项目在 Git 仓库中，review 面板会基于项目 Git 状态显示变更，包括 Codex 没有编辑过的文件。

步骤 1：先确认 Git 当前状态

在内置终端或本地终端运行：

git status --short

如果在 Codex 执行前工作区就已经有未提交文件，review 面板会把这些文件也显示出来。

这不是 Codex 乱改，而是 review 面板在展示当前仓库状态。

步骤 2：区分 staged 和 unstaged

Git 里常见两类改动：

• staged：已经加入暂存区，下一次 commit 会包含。
• unstaged：工作区里改了，但还没暂存。

Codex App 的 diff 面板可以在这些状态之间切换。检查时先看当前视图显示的是哪一类，而不是直接假设所有文件都是 Codex 改的。

步骤 3：切到 Last turn changes

如果你只想看 Codex 上一轮实际改了什么，切换到 Last turn changes。

这个视图适合回答两个问题：

• Codex 这一轮到底碰了哪些文件？
• 当前回复和 diff 是否匹配？

如果 Last turn changes 很小，但总 review 列表很大，通常说明工作区之前就有其他未提交改动。

步骤 4：让 Codex 解释改动来源

你可以直接问：

请区分当前 diff 中哪些是你本轮修改的，哪些是此前已经存在的未提交改动。
不要回滚任何文件，只做说明。

这样可以避免 Codex 误把用户已有改动当成自己要清理的内容。

步骤 5：提交前再做一次确认

提交前建议运行：

git diff --stat
git status --short

如果你只想提交 Codex 本轮改动，先逐个检查文件，必要时拆分提交。

常见错误

不要看到侧边栏文件多就立刻让 Codex “全部恢复”。这可能会丢掉你自己或其他工具的未提交改动。

不要只看文件数量，不看 Last turn changes。

不要把 unrelated changes 混进同一个提交。提交前先确认范围。

小结

Codex App review 面板展示的是 Git 状态，不一定等于 Codex 本轮改动。遇到文件列表异常时，先查 git status，再切到 Last turn changes，最后决定是否提交、拆分或继续处理。