189、最小可复现用例：高质量的 bug report 怎么写，让 AI 和同事都能秒懂

189、最小可复现用例：高质量的 bug report 怎么写，让 AI 和同事都能秒懂

上周五下午，我正盯着一个诡异的线上问题——用户上传的Excel文件偶尔会解析失败，但本地测试一切正常。我花了整整两个小时，翻日志、查数据、对比环境，最后发现是文件编码问题。更让我崩溃的是，同事在群里甩了一句：“那个上传功能好像有点问题，你看看？” 没有报错信息，没有复现步骤，没有示例文件。这种bug report，基本等于没写。

后来我花了十分钟，自己写了一个最小可复现用例（Minimal Reproducible Example，简称MRE），丢给GPT-4，它直接指出了问题所在。那一刻我意识到：写bug report的能力，比写代码的能力更值钱。

什么是最小可复现用例

最小可复现用例不是把整个项目代码贴过来，也不是截一张错误截图。它是一个独立的、可运行的、能稳定复现问题的最小代码片段。核心就三个字：小、全、稳。

小——只保留触发bug的必要代码，去掉无关的业务逻辑。全——包含所有必要的导入、数据和配置，别人复制就能跑。稳——每次运行都能复现，不是偶发问题。

我见过最离谱的bug report，是同事把整个微服务仓库的链接发过来，说“你pull下来跑一下，第37个接口有问题”。这种操作，基本等于把自家钥匙给锁匠，然后说“你帮我看看这把锁为什么打不开”。

为什么AI和同事都需要MRE

先说AI。大模型处理代码的能力很强，