返回知识库

调试与质量 · 发现与复现

复现步骤Reproduction Steps

复现步骤是一份可跟着做的编号清单:写齐必要环境、操作和实际结果,并用连跑频率证明它稳定。

先认出这份步骤,再看它稳不稳

下面就是一份结账故障的复现清单。含糊步骤会写「无法复现」;编号步骤连跑 5 次后,频率长在第 4 步上。

  1. 1用你的浏览器打开一下
  2. 2登录一下试试
  3. 3随便点点提交
  4. 4等待实际结果还没跑

还不能叫复现现在只有「登录一下试试」。下一步:先跑一遍,看别人能不能跟着做。

复现步骤是一份可跟着做的编号清单。第 4 步上的频率就是判断:5/5 才能交接;换环境失败的原因是缺必要因子,下一步写回环境再跑。

知识点:必要因子写进步骤,频率写在最后一步

上面的清单已经演示了核心关系,这里只给可复用的命名。

  • 环境、账号状态和缓存是必要因子,不能写成「打开一下」。
  • 步骤要编号、可跟着做;实际结果写在最后一步。
  • 连跑多次才算稳定;换环境消失,说明缺因子,不是「我这好好的」。

什么时候用、怎么用

要把故障交给别人、写进 issue,或确认自己真的看见同一现象时,先写复现步骤。

  • 信号:对方回「我这好好的」,或自己隔天再也点不出来。
  • 不适用:还没观察过实际结果,或步骤依赖本机未提交的脏数据。
  • 最短路径:写齐环境 → 编号操作 → 写下实际结果 → 连跑确认频率。

正反例:同一结账故障,只改步骤清不清楚

目标都是让别人看见「留空地址点提交无反馈」。差别只在步骤能不能被跟着做。

正例Safari 17 + 四步编号 + 5/5

未登录、旧缓存、留空地址点提交;五次都无反馈,接手者按同样条件也能看见。

反例「登录一下试试」或只跑一次

对方换浏览器就消失;单次命中可能是偶发,不能当作稳定复现。

快速自测

同事按你的步骤在 Chrome 里复现不了。第一步该补什么?

继续查证

术语的技术定义和行为以这些一手或权威资料为准。

下一步学

和本知识点经常一起出现的概念。