Simon Willison's Weblog
来自 Armin Ronacher 的一段话
7.2Score
TL;DR · AI 摘要
Armin Ronacher 批评当前开源项目中的问题报告质量差，主张简化为‘我做了什么、期望什么、实际发生了什么、错误日志’四步法。
核心要点
- 当前问题报告常被重写导致信息失真，影响根本原因分析。
- 建议采用四步法：操作步骤、预期结果、实际结果、错误日志。
- 高质量问题报告应保留用户原始观察，减少主观臆断。
结构提纲
按章节快速跳转。
当前问题报告常被重写，导致信息失真和误导。
问题描述不清晰，结论往往不准确但充满自信。
推荐使用四步法来记录问题：操作、预期、实际、日志。
包括运行命令、期望行为、实际行为和精确错误信息。
高质量报告有助于提升开发效率和问题解决准确性。
思维导图
用一张图看清主题之间的关系。
查看大纲文本（无障碍 / 无 JS 友好）
- Issue Reporting Quality
- Current Problems
- Misrepresentation
- Inaccurate Conclusions
- Proposed Solution
- Four-step Format
- Human Observation Focus
金句 / Highlights
值得收藏与分享的关键句。
当前最令人沮丧的问题模式是人们提交的报告并非他们自己的声音。
至少对我个人而言，我越来越希望问题报告能简化为人类实际观察到的内容：
我运行了这个命令。我期望发生这件事。结果却发生了别的事。这是确切的错误或日志。
#开源#Issue Report#软件工程#用户体验
打开原文2026年5月24日
目前最令人沮丧的失败模式是，人们提交的问题不是用他们自己的语言表达的。问题中可能包含某个观察到的现象，但被混杂在一起，重新表述后变得一团糟。通常，问题是由于糟糕的引导而产生的，因此得出的结论往往不准确，但却总是充满自信。结果是对根本原因的完全猜测、虚假的最小复现、建议的实现策略、与相邻但通常是错误代码的类比，以及一长串可能无关紧要或重要的错误类别。[...]
所以至少对我个人而言，我越来越希望问题报告能简化为人类实际观察到的内容：
1. 我运行了这个命令。
2. 我期望发生这种情况。
3. 结果却发生了别的事。
4. 这里是确切的错误信息或日志。
— Armin Ronacher，关于针对 Pi 提交的混乱问题报告