用Codex修复Bug并补回归测试：从复现到最小补丁

本练习只约定四件事：输入 12.5 显示 ¥12.50，输入 0 显示 ¥0.00，订单没有 amount 或格式化函数收到 undefined 时显示 --，订单顺序和接口结构保持不变。null、空字符串、非数字文本、币种转换和精度策略不在本次范围内。

先固定现象

准备练习副本

这是基于原文案例整理的独立教学示例，不是原生产项目。你需要已完成基础课程、能打开练习目录的 Codex 入口，以及 Node.js 22 或更高版本、一个终端和可以查看文本差异的编辑器。本练习使用 Node 内置 node:test 和 node:assert/strict，不需要安装依赖、初始化 Git 或打开真实业务仓库。

解压后进入 bug-regression-lab/。包内的 starter/ 保留已知缺陷，reference/ 单独放置参考测试和修复；实际操作前先复制一份起点。

bug-regression-lab/
├── README.md
├── TASK.md
├── CHECKLIST.md
├── starter/
│   ├── src/formatAmount.mjs
│   ├── demo.mjs
│   └── test/formatAmount.test.mjs
└── reference/
    ├── formatAmount.fixed.mjs
    ├── formatAmount.regression.test.mjs
    └── 参考差异.md

在练习包根目录运行下面的命令。macOS/Linux 使用第一组，Windows PowerShell 使用第二组。

node --version
cp -R starter bug-regression-work
cd bug-regression-work

node --version
Copy-Item -Recurse starter bug-regression-work
Set-Location bug-regression-work

本轮实际使用 macOS 15.6、Node.js v22.11.0。如果找不到 node 或版本过低，先准备兼容环境；不要修改网站项目的 Node 版本和锁文件。

运行已有测试，再运行复现命令

“复现”是用固定输入稳定看到同一个错误；“断言”是代码对结果的明确要求，例如实际值必须等于 ¥12.50。“回归测试”把已经确认的正确行为保存成可重复执行的检查，后续修改时继续检查它。

在 bug-regression-work/ 内执行：

node --test test/formatAmount.test.mjs
node demo.mjs

已有测试只检查正常金额和合法的零值。本轮实际结果是 2 条测试通过，复现命令输出：

A-100: ¥12.50
A-101: ¥NaN

这说明旧测试覆盖的行为正常，而缺失金额的错误可以稳定出现。测试通过不等于没有 Bug。

图一：原文示意图，展示正常金额和缺失金额的输出关系；本轮练习的真实结果以你运行的终端命令为准。

先问根因，再写补丁

在 Codex 中打开 bug-regression-work/，先发送下面的只读提示词。它是发给 Codex 的内容，不是终端命令。

请只读调查当前练习，不要修改、创建或删除文件。
从 demo.mjs 的订单对象开始，追踪 amount 如何传给 src/formatAmount.mjs，说明 undefined 为什么会变成 ¥NaN。
同时读取 test/formatAmount.test.mjs，列出已有断言覆盖了什么、没有覆盖什么。
请给出最小修改文件、必须保持不变的输入输出和仍未确认的边界。
不要安装依赖、初始化 Git 或扩大到 reference/目录。

实际代码链很短：demo.mjs 读取缺少 amount 的订单，把 undefined 传给 formatAmount；起始实现执行 Number(undefined).toFixed(2)，得到字符串 NaN，再拼上货币前缀。修复应放在格式化函数入口，不能只在最终文本中替换 NaN。

图二：流程示意图，帮助理解复现、定位、测试和修复之间的顺序，不是 Codex 客户端截图。

最小修复的形状

先只增加回归测试

保持 src/formatAmount.mjs 不变，在 test/formatAmount.test.mjs 末尾增加下面的测试。不要删除或修改已有的 12.5 和 0 断言。

test("uses the placeholder when amount is missing", () => {
  assert.equal(formatAmount(undefined), "--");
});

也可以把下面的提示词发送给 Codex：

只修改 test/formatAmount.test.mjs。
保留现有 12.5 和 0 的断言，新增一条 formatAmount(undefined) 应返回 "--" 的回归测试。
不要修改 src/formatAmount.mjs，不要改测试期望，不要运行安装、构建或部署命令。
完成后展示修改文件和测试差异，先不要修实现。

在同一个 bug-regression-work/ 目录重新运行：

node --test test/formatAmount.test.mjs

本轮实际结果是 3 条测试中 2 条通过、1 条失败，失败原因是断言看到了 ¥NaN，但期望是 --，退出状态为 1。如果看到路径、导入或 Node 缺失错误，先检查当前目录和版本，不要把那种失败当作回归测试生效。

再做最小实现修改

测试已经证明旧实现不满足约定后，再发送第三段提示词：

现在只修改 src/formatAmount.mjs，并运行 node --test test/formatAmount.test.mjs 和 node demo.mjs。
当参数严格等于 undefined 时返回 "--"；其他现有数字继续使用原来的两位小数和 ¥ 前缀。
不要使用 if (!value)，不要改订单顺序、demo.mjs、测试期望或其他目录。
完成后报告修改文件、两条命令的真实输出和退出状态。

目标实现是：

export function formatAmount(value) {
  if (value === undefined) {
    return "--";
  }

  return `¥${Number(value).toFixed(2)}`;
}

用同一组命令验收：

node --test test/formatAmount.test.mjs
node demo.mjs

本轮实际结果是 3 条测试全部通过，复现命令变为：

A-100: ¥12.50
A-101: --

这里使用 value === undefined 是为了保留 0 的合法含义。用 if (!value) 会把 0 一起当成缺失值，原有零值测试会暴露这个错误。

区分修复与掩盖

完成测试后，检查两个文件的差异（diff）：哪些行被增加、删除或替换。练习副本没有要求 Git，可以使用编辑器的比较功能；也可以在 Bash 中运行：

diff -u ../starter/src/formatAmount.mjs src/formatAmount.mjs
diff -u ../starter/test/formatAmount.test.mjs test/formatAmount.test.mjs

预期只有两类变化：格式化函数增加 undefined 分支，测试文件增加缺失金额断言。diff 发现差异时退出状态为 1 是正常情况；2 才表示执行出错。demo.mjs、接口字段和订单顺序都不应变化。PowerShell 可以用编辑器的文件比较功能，或用 Compare-Object 查看对应文件。

图三：概念示意图；真正的验收仍然依赖测试、复现输出和文件差异，不依赖图片。

交付检查

在另一份副本中检查测试敏感性

为了确认你刚运行通过的同一组测试确实能抓住原始缺陷，在另一份临时副本中保留原始实现，只复制最终测试。从当前 bug-regression-work/ 返回上一级 bug-regression-lab/，在 macOS/Linux 终端运行：

cd ..
cp -R starter sensitivity-check
cp bug-regression-work/test/formatAmount.test.mjs sensitivity-check/test/formatAmount.test.mjs
node --test sensitivity-check/test/formatAmount.test.mjs

Windows PowerShell 使用：

Set-Location ..
Copy-Item -Recurse starter sensitivity-check
Copy-Item bug-regression-work/test/formatAmount.test.mjs sensitivity-check/test/formatAmount.test.mjs
node --test sensitivity-check/test/formatAmount.test.mjs

如果 sensitivity-check/ 已存在，换一个新目录名，不覆盖旧副本。如果 Codex 跳过了先失败阶段，保留当前修复，再执行本节复核；无需反复重跑模型对话。

本轮实际结果仍是 3 条测试中 2 条通过、缺失金额断言失败，退出状态为 1。这一步没有回滚 bug-regression-work/，也没有覆盖 ZIP 内的 starter/。

结果表

这组结果证明测试覆盖了当前约定的缺失金额边界。它不证明 null、空字符串、非数字文本、币种和精度策略已经确定，也不宣称所有 Codex 客户端都完成了端到端验证。

常见问题、重新开始和下一步

• 新测试一加就找不到模块：确认终端在 bug-regression-work/，并检查文件名是否为 .mjs。
• 新测试没有失败：确认没有提前修改 src/formatAmount.mjs，且断言确实是 formatAmount(undefined) === "--"。
• 0 变成 --：检查是否使用了 if (!value)，改为只判断 value === undefined。
• 修改超出两个文件：保留现有副本，把 ZIP 重新解压到一个全新的目录，再复制其中的 starter/，不要执行 git reset --hard 或清空真实项目。
• 想确认更广泛的金额规则：先为 null、空字符串、非数字文本、币种和精度分别取得产品约定，再单独增加测试。

完成本篇后，可以继续阅读验证流程，把“复现—断言—最小修改—差异—复测”迁移到真实项目；涉及页面交互时，再看浏览器验收教程。五课短课程仍保持原顺序，本篇是完成基础练习后的选学内容。

参考资料

• OpenAI Codex Best Practices
• Node.js `node:test` 文档
• Node.js `node:assert` 文档

原文标题为《Codex 修复可复现 Bug：让补丁只解决当前问题》，作者记录沿用 codx编辑组，原始发表时间为 2026-09-01。原文另有 Windows 11 24H2（Build 26100）、PowerShell 7.6.4、Codex CLI 0.147.0、Git 2.47.0、2026-08-30 核验的历史环境记录；本轮未重跑该环境，也不据此推断原作者是否执行过新回归测试。本轮教学示例和命令于 2026-09-23 在 macOS 15.6、Node.js v22.11.0 的独立临时副本中执行；未验证 App、交互式 CLI、IDE 和其他操作系统中的端到端行为。