原文链接： How to Report Bugs Effectively

书评

《如何有效报告Bug》是一篇实用性极强的技术指南，作者Simon Tatham以简洁幽默的语言，深入浅出地讲解了如何高效地向程序员报告软件问题。文章的核心思想是：让程序员亲眼看到问题。通过生动的比喻（如“不要做猫鼬，要做羚羊”）和生活中的类比（如看医生时的症状描述），作者强调了准确、清晰和详细的重要性。

这篇文章不仅适合程序员，也适合任何需要与技术团队沟通的用户。它教会我们如何避免无效的沟通，如何提供有价值的信息，以及如何在面对问题时保持冷静。文章的逻辑清晰，语言风趣，读起来轻松愉快，同时又能让人深刻反思自己在报告问题时的常见错误。

---

笔记

核心原则

1. 首要目标：让程序员亲眼看到问题

如果能当面演示，直接展示问题。

如果无法当面演示，提供详细的复现步骤，确保程序员能自己复现问题。

2. 次要目标：详细描述问题

描述你看到的现象和预期的结果。

记录错误信息，尤其是包含数字的部分。

3. 保持冷静，避免误操作

当程序出现异常时，先暂停操作，保持冷静，避免进一步破坏现场。

4. 提供额外信息

准备好版本号、环境信息等，以备程序员询问。

不要觉得程序员在刁难你，他们需要这些信息来定位问题。

5. 清晰、准确地表达

避免模糊的描述，确保你的表达不会被误解。

程序员喜欢精确的信息，细节越多越好。

实用建议

不要自作聪明地诊断问题

你可以尝试分析问题，但最终报告时，仍然要描述症状，而不是直接给出结论。
例如，不要说“tachyons调制极性错误”，而是描述程序的具体行为和错误信息。

类比：看医生时的症状描述

就像你不会对医生说“给我开点Hydroyoyodyne”，而是描述你的症状（如发烧、疼痛），让医生诊断。同样，报告Bug时，描述现象，而不是猜测原因。

程序员的心理

程序员喜欢精确的信息，因为他们需要通过这些信息来定位问题。模糊或不完整的描述会让他们难以理解问题，甚至可能忽略你的报告。

---

总结

报告Bug的本质是帮助程序员快速定位问题。通过提供清晰的复现步骤、详细的描述和必要的信息，你可以大大提高问题解决的效率。记住：精确、清晰、冷静是有效报告Bug的关键。