Codex 代码审查常见错误和修复顺序

Codex 生成的代码不一定会“明显坏掉”。更常见的情况是：页面能打开，但某个边界状态错了；测试能跑一部分，但构建失败；客户看到效果，却发现需求被误解。新手做人工审核时，最危险的不是发现错误，而是发现错误后继续扩大修改范围，最后连原始问题都说不清。

这篇文章按“常见错误”和“修复顺序”来写。若你需要完整审核流程，先看 Codex 生成代码后怎么人工审核；若你只想拿一张表逐项检查，读 人工审核检查清单。

适合谁

适合已经让 Codex 改过代码，并遇到过这些情况的人：改完后 lint 报错、页面布局异常、依赖安装失败、客户需求没覆盖、移动端出问题、接口返回不对，或自己看不懂改动原因。

也适合准备接小单的新手。项目不是展示“我能让 AI 写代码”，而是展示“我能发现问题、缩小范围、给出可验证的处理方式”。这比一开始写很复杂的方案更实际。

不适合谁

不适合正在处理高风险生产系统、但没有足够经验独立判断的人。涉及真实交易、用户隐私、权限升级、数据库迁移、安全漏洞和大规模线上服务时，不应只靠这篇文章做决策。

也不适合把所有错误都丢回给 Codex 反复重写的人。AI 可以辅助排查，但你必须知道自己要保留什么、撤回什么、验证什么。

风险提醒

修 bug 最容易陷入“越修越大”。例如原本只是按钮错位，Codex 却重写了整个组件；原本只是接口字段名错了，它却改了数据模型；原本只是构建报错，它却升级了一堆依赖。新手看到“问题解决了”会很开心，但客户后面可能面对更多副作用。

还有一种风险是证据不足。你说“我修好了”，但没有命令输出、截图、测试路径、剩余风险说明。这样的交付很难让客户信任，也不利于你复盘。

具体步骤

第一步：保住现场

先不要继续让 Codex 大改。保存当前 diff、报错日志、截图和复现步骤。如果工作区里已经有很多改动，先把它们分组：哪些是任务相关，哪些是 AI 顺手改的，哪些你完全看不懂。

如果你在 git 项目里，可以先看状态和差异，再决定是否撤回某些无关改动。不要在没看清楚前清空所有变化，因为那会丢掉可分析的线索。

第二步：回到原始需求

问自己三个问题：客户最初要解决什么？Codex 实际改了什么？现在失败在哪里？如果三者对不上，先停止追加功能。很多问题不是技术能力不够，而是需求被工具带偏了。

可以用 Proposal 生成器把需求重新写成“目标、范围、材料、验收标准、风险确认”五个块。这样你会更容易发现哪些信息缺失。

第三步：按严重程度排序

优先处理会阻止项目运行的问题，例如安装失败、构建失败、页面白屏、关键接口不可用。其次处理功能错误，例如按钮无效、数据不更新、表单不校验。最后处理体验问题，例如间距、文案、加载状态和移动端细节。

不要先修最顺手的小问题。顺手不等于重要。客户项目里，客户最关心的是核心路径能否完成。

第四步：最小化修改

让 Codex 修复时，prompt 要限制范围。例如：“只解释这个报错，不要修改文件”“只改这个组件，不要新增依赖”“先给出可能原因和验证命令”。这样可以减少它继续扩散改动的概率。

遇到报错日志看不懂，先用 报错解释器拆成现象、可能原因、验证命令和下一步，再决定是否让 Codex 生成补丁。

第五步：重新验证

每修一轮，只验证和本轮相关的路径。比如修样式就截图桌面和移动端；修接口就跑成功和失败请求；修构建就重新 build；修表单就测试空值、错误输入和正常提交。

验证后要写记录。记录不是为了好看，而是为了防止你忘记自己做过什么。做项目时，这些记录也能变成交付说明。

常见错误清单

第一类错误是“只看最终效果”。页面看起来正常，不代表依赖、构建、错误状态和移动端都正常。第二类错误是“相信 AI 解释”。Codex 解释得顺畅，不代表它引用的 API、配置和版本就正确。第三类错误是“忽略无关改动”。很多副作用就藏在看似无关的配置或共享组件里。

第四类错误是“没有暂停点”。当你连续三次让 AI 修同一个问题还没解决，就应该暂停，重新收集日志，而不是继续扩大范围。第五类错误是“把不确定写成确定”。对客户沟通时，应该区分已验证、待确认和暂未覆盖。

修复顺序示例

假设客户让你修一个 Next.js 页面，Codex 改完后移动端正常了，但 build 失败。正确顺序不是继续调样式，而是先看 build 报错，再检查是否新增了不兼容 API 或导入路径。build 恢复后，再回到移动端截图，最后写交付记录。

假设客户让你接一个接口，Codex 生成了请求逻辑，但没有错误处理。此时先不要急着美化 UI，而是确认接口字段、鉴权方式、失败响应和加载状态。若缺少测试账号或接口文档，应把它列为客户确认项。

CTA：下一步

把一个失败案例整理成三列：原始需求、Codex 改动、当前错误。再用 人工审核检查清单逐项复查，并从 模板库 里选一个复盘模板写成作品集草稿。

免责声明

本文是学习和排查流程，不构成法律、财务、安全或职业承诺。具体项目要结合真实代码、客户授权、平台要求和风险级别判断。重要交付前，请由具备相应经验的人最终复核。