AI Agent / 系统课时

定位并修复缺陷

定位并修复缺陷

缺陷修复的关键不是“让 Codex 猜哪里错了”,而是把问题变成可重复失败,再让它沿着测试、日志和调用路径收集证据。最终应得到一个范围尽可能小的补丁,并用原始失败用例和相关回归测试证明问题确实消失。

学习目标

  • 把模糊的故障描述转换成稳定、可观察的复现步骤
  • 引导 Codex 从失败证据定位根因,而不是直接试错式改代码
  • 用最小补丁、回归测试和差异审查完成修复验收

先把问题固定成一次稳定失败

开始前先确认工作区中没有与本缺陷无关的未提交修改,并记录复现命令、输入数据、实际结果和期望结果。能用单个失败测试复现时,优先使用测试;只有测试无法覆盖现场时,才把日志、请求样例或运行参数补进证据集。

下面用一个边界条件错误演示。请在空的临时练习目录执行,避免覆盖真实项目文件。示例使用 Python 标准库 unittest,不依赖第三方测试框架。

bash
git init -q
cat > pricing.py <<'PY'
def final_price(unit_price: float, quantity: int) -> float:
    discount = 0.10 if quantity > 10 else 0.0
    return unit_price * quantity * (1 - discount)
PY

cat > test_pricing.py <<'PY'
import unittest
from pricing import final_price

class PricingTest(unittest.TestCase):
    def test_bulk_discount_boundary(self):
        self.assertEqual(final_price(10.0, 10), 90.0)

if __name__ == "__main__":
    unittest.main()
PY

python -m unittest -q

预期输出:

text
======================================================================
FAIL: test_bulk_discount_boundary (test_pricing.PricingTest.test_bulk_discount_boundary)
...
AssertionError: 100.0 != 90.0
...
FAILED (failures=1)

不同 Python 版本会改变堆栈行号和耗时,但核心证据应保持不变:数量恰好为 10 时没有应用预期折扣。

让 Codex 先解释证据再修改

第一次交互不要只写“修复这个 bug”。把失败命令、期望行为和修改边界一起交给 Codex,并要求它先复现、定位根因,再做最小修改。这样可以把“猜测正确答案”变成“依据仓库事实做判断”。

bash
codex exec '复现 python -m unittest -q 的失败。先说明失败测试覆盖的业务边界、定位根因和涉及的最小代码范围;然后修复缺陷,不修改测试的期望值。修复后重新运行原测试,并检查是否需要补充相邻边界测试。'

预期输出:

text
<VALUE>

<VALUE> 代表 Codex 针对当前仓库生成的最终说明,具体措辞会变化。验收重点不是这段文字,而是它是否实际复现失败、给出与代码一致的根因,并在修改后提供可验证的测试结果。

从失败现象到修复验收的证据链

根因要落到可证伪的代码条件

好的根因说明应同时回答三个问题:哪个条件与需求不一致、为什么只在特定输入触发、为什么这处修改足以修复。示例中的业务边界是“数量达到 10 即打折”,而代码写成了 quantity > 10,因此真正的修复点是比较运算符,而不是测试数据、折扣比例或返回类型。

修复后建议检查相邻边界,例如 9、10、11 三个数量值。边界错误常常只在一个离散点暴露,单独让原失败用例转绿并不能证明附近行为都正确。

用原失败测试和差异完成验收

Codex 修改完成后,人工再运行验证命令,不要只接受它的文字结论。

bash
python -m unittest -q
git diff --check
git diff -- pricing.py test_pricing.py

预期输出:

text
----------------------------------------------------------------------
Ran 1 test in <TIME>s

OK

git diff --check 在没有空白错误时通常不输出内容;git diff 应只展示与本缺陷直接相关的改动。实际项目还应继续运行受影响模块的测试、静态检查或构建命令。如果原始复现已通过,但补丁同时改动了无关文件、删除了断言或放宽了错误处理,应视为未完成修复而不是“顺便优化”。

一个可靠的缺陷修复闭环应能被其他开发者重复:拿到同一复现步骤先看到失败,应用补丁后看到通过,并能从差异中解释为什么行为发生了变化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位并修复缺陷

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通