### [Codex 修复 Bug 的正确流程：先复现、再缩小范围、最后验证回归](https://alyyhw.com/article/4410)

**Published:** 2026-07-28T16:06:38

**Author:** AI菜鸟网

**Excerpt:** 修 Bug 不要从改代码开始。先复现现象、缩小范围、建立失败证据，再让 Codex 提出最小修复和回归验证。

“页面偶尔打不开”不是可修复的问题描述。它缺少触发条件、期望结果和失败证据。Codex 在这种模糊输入下很容易写出看似合理、却无法验证的补丁。先把现象压缩成一次稳定复现，修复才有终点。

![从 Bug 复现到范围收敛和回归验证的开发流程](https://login.alyyhw.com/wp-content/uploads/2026/07/codex-bug-fix-workflow.jpg)

复现、定位、最小修复、回归验证，顺序不能颠倒。

## 问题单至少写五项

-   环境：版本、分支、账号或数据条件；
-   步骤：从什么操作开始，到哪里出现失败；
-   期望与实际：用户本该看到什么，实际发生什么；
-   证据：报错、日志、截图或失败测试；
-   范围：目前确认受影响的功能和未确认的猜测。

## 让 Codex 先缩小，不要先修

先让它根据证据列出可能路径，并设计能区分这些路径的最小检查。确认根因后，再要求仅修改必要文件、补一条能先失败后通过的测试。修复完成后，除了重跑失败场景，还要检查相邻流程。

```
根据以下复现步骤和日志：
1. 列出三个最可能的代码路径；
2. 为每条路径设计最小验证；
3. 未确认根因前不要修改；
4. 根因确认后提出最小补丁与回归清单。
```

修复的质量不在于改得快，而在于你能证明：旧问题消失了，邻近功能没有被带坏。

**Tags:** AI编程

**Categories:** AI编程

---