返回知识库

调试与质量 · 发现与复现

问题报告Bug Report

问题报告是一张可交接工单:把环境、步骤、实际/预期和脱敏证据写在票面上,猜测单独标成假设。

先认出这张工单,再看它能不能被接手

下面就是一张登录故障工单。缺字段或把假设写成定论时,退回章盖在工单上;字段齐全后才进入待复现。

ISSUE · BUG-184未分级
Safari 登录没有反馈

这里坏了,很急马上修。

尚未提交

还不能交接现在只有一句「登录坏了」。下一步:先提交,看接手者能不能复现。

问题报告是一张可交接工单。退回章和待复现章都盖在票面上;下一步看字段齐不齐,而不是催得急不急。

知识点:事实写在工单上,猜测单独标

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

  • 标题说清现象,严重度标出影响面。
  • 环境、编号步骤、实际 vs 预期是接手门槛。
  • 证据要脱敏;假设可以写,但不能当结论。

什么时候用、怎么用

需要别人接手、跨环境复现,或要把现象固化进 issue 时写报告。

  • 信号:自己说不清环境,或对方回「我这好好的」。
  • 不适用:还没观察过实际/预期,或证据含密钥尚未脱敏。
  • 最短路径:写环境 → 编号步骤 → 并列实际/预期 → 附脱敏证据 → 假设单独标。

正反例:同一登录故障,只改有没有事实

目标都是让别人接手 Safari 登录无反馈。差别只在工单有没有可验证字段。

正例环境 + 步骤 + 实际/预期 + 单独假设

Safari 17;密码留空点登录;实际无提示,预期字段错误;假设「可能是缓存」单独写出。

反例「登录坏了很急」或把缓存写成定论

接手者无法复现,只能来回追问;假设冒充结论会带偏修复方向。

快速自测

同事回「我这复现不了」。哪一项最该先补进工单?

继续查证

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

下一步学

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