第 5 天

处理第一次报错

今天把报错变成可复现的事实:先记录现象和完整错误,再定位最小原因,修复后重复同一条路径。

建议时间
50-70 分钟
完成标志
报错卡 + 修复与复测

先选择一个真实故障

如果第 4 天已经出现未通过项,直接使用它。若所有检查都通过,可下载课程故障练习包。它故意让按钮反馈失效,修好后仍然是一个完整的个人造物名片。

故障练习个人造物名片按钮故障包ZIP,已明确标注练习用途,不覆盖正常起步包
不要在真实项目里故意乱删

练习包已经隔离好故障。真实项目只处理已经观察到的问题,不靠制造更多问题来学习。

把现象和猜测分开

“按钮坏了”是现象,“事件监听器写错了”是原因假设。先记录能看见和能复制的事实,再让 Codex 结合文件判断。

复现从正常起点重复操作,确认问题稳定出现。
记录保存实际现象、完整报错和最近改动。
定位把原因判断绑定到具体文件与证据。
复测修复后重复原路径,并检查相关旧功能。

这些输入不会保存。填写后手动替换进下面的诊断指令。

先诊断,不要边猜边改

完整报错比转述更有用。若只有截图,先把关键文字抄下来;若没有可见报错,也如实写明。

故障诊断
请先诊断,不要修改文件,也不要安装依赖。

项目:个人造物名片网页
期望行为:点击“查看我的第 16 个案例”后,页面显示“我的第一版目标:邀请一位真实用户试用。”
实际现象:[粘贴你看到的现象]
复现步骤:[写出从打开页面到出现问题的最短步骤]
完整报错文字:[原样粘贴;如果没有报错文字,写“没有可见报错”]
最近一次改动:[填写刚才修改了什么]

请输出:
1. 从现有文件和报错中能够确认的事实。
2. 最可能的原因,以及支持这个判断的文件位置或报错证据。
3. 还不能确认的内容。
4. 一个只处理当前故障的最小修复计划。
5. 修复后必须重复执行的测试步骤。

不要顺手重构,不要修改与当前故障无关的文件。等待我确认修复计划。
可以确认修复计划的条件
  • 原因判断指向真实存在的文件和位置。
  • 计划只处理当前故障。
  • 修复后会重复原来的复现步骤。

执行最小修复并复测

修复成功不等于课程结束。原故障要消失,相关旧功能也要保持正常,这两件都需要实际操作。

确认修复
我确认这份最小修复计划。请按计划修复当前故障。

要求:
1. 只修改计划中列出的文件和位置。
2. 不增加新功能,不改样式,不重写页面。
3. 完成后重复执行原来的复现步骤。
4. 再执行与本次修改有关的原有功能测试。
5. 报告实际修改、测试动作、观察结果,以及仍未验证的内容。

如果修复计划与实际文件不一致,请停止并说明差异,不要猜着改。
整理复测
请整理本次故障的修复与复测记录:

1. 原始现象和完整报错。
2. 根因及对应证据。
3. 实际修改的文件和内容。
4. 原复现步骤现在是否通过。
5. 按钮反馈、页面刷新和 390 像素宽度是否仍正常。
6. 哪些内容仍未验证。
7. 为避免同类问题,下次工作说明书或测试表应增加哪一条检查。

只写真实执行过的结果,不补写想象中的测试。
下载材料第 5 天报错卡与复测记录Markdown,可保留故障证据和修复决定
当天交付物

报错卡 + 修复与复测

一张合格的报错卡,应当让另一个人按相同步骤看见问题,也能知道为什么只改了这个位置。

查看后续课程路线