【问题标题】:Good newbie instructions for creating minimal complete bug examples? [closed]创建最小的完整错误示例的良好新手说明? [关闭]
【发布时间】:2010-10-30 07:49:28
【问题描述】:

因此,我们这些回答问题和处理错误报告已有一段时间的人都非常熟悉“完整的最小示例”的概念。你从一大堆粗糙的代码开始,其中有一个奇怪的错误,你想询问某人。但是你不想把整个乱七八糟的东西都发给他们,所以你开始把一堆代码切成小块,直到你得到这个结晶的 20 行小宝石,它仍然有你开始时的错误。

(然后,至少有一半的时间,你会意识到这个错误是什么,因为它像月蛾一样盯着你的脸,而且你根本不必问。但这是一个副作用。)

进行这种代码缩减并不是每个人都具备的技能——这需要一些练习,除了很多新手还没有学会他们应该首先做到这一点之外.对于新手来说,有几套关于如何提出好问题的优秀说明(例如,ESR 的经典“How To s The Smart Way”)。那里有很好的说明来解释什么是最小完整示例,以及如何以及为什么要创建它们?

【问题讨论】:

    标签: debugging


    【解决方案1】:

    一切尽在名下。完整的最小示例是完整且最小的示例。完整意味着它包含所有相关信息,最小意味着它不包含不相关的信息。识别什么是无关紧要的能力只能通过练习来实现——尝试为此提供指导似乎有点像尝试提供骑自行车的指导。您可以提供技术解释并描述机制(您链接到的 TeX FAQ 做得很好),但最终真正学习的唯一方法就是实践。

    【讨论】:

    • 我并不完全同意——即使学习某件事的唯一方法是通过实践,也几乎总是可以举例说明过程是什么样的以及它是如何完成的。尽管如此,你所说的可能有相当多的真实性。感谢您的回答!
    【解决方案2】:

    我将从我熟悉的那些开始;这些都来自 TeX 社区,因此对于编程来说有点倾斜。我希望其他人有更好的答案。

    TeX 常见问题解答在 How to make a “minimum example” 上有一个条目。

    该页面指向"What is a minimal working example?" 上的一篇稍长的文章。同样,这是针对 TeX 文档的;想法相同,但工具和细节略有不同。

    编辑 (2013/01): 我在 StackOverflow 评论中注意到的另一个:"Short, Self Contained, Correct (Compilable), Example" page。不完美,它建议将 20kb (!) 作为上限,但对列表来说是一个很好的补充。

    编辑 (2013/02):Jon Skeet 有 a blog post 关于编写好问题,其中包括一个关于示例代码的部分似乎很有用。

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 2013-08-08
      • 2014-09-07
      • 1970-01-01
      • 2020-01-07
      • 2016-04-12
      • 1970-01-01
      • 2012-04-30
      • 2012-02-23
      相关资源
      最近更新 更多