如何有效地报告 Bug

https://www.chiark.greenend.org.uk/~sgtatham/bugs-cn.html

我很是但愿每个人在报告bug以前都读一下这篇短文，

您能够亲自示范，也能够给出能致使程序出错的、详尽的操做步骤。

若是程序附带了一套报告bug的准则，必定要读。

报告bug的最好的方法之一是“演示”给程序员看。

确切地告诉程序员您作了些什么。若是是一个图形界面程序，告诉他们您按了哪一个按钮，依照什么顺序按的。若是是一个命令行程序，精确的告诉他们您键入了什么命令。您应该尽量详细地提供您所键入的命令和程序的反应。

精确的描述您看到了什么。告诉他们为何您以为本身所看到的是错误的，最好再告诉他们，您认为本身应该看到什么。若是您只是说：“程序出错了”，那您极可能漏掉了很是重要的信息。

。只报告“程序出了一个错”是毫无心义的

您看到了什么，您想看到什么，把错误消息记下来，若是有错误消息号， 必定 要把这些号码告诉程序员。不要觉得您看不出任何意义，它就没有意义。

程序可能会产生一个内核输出（coredump）。内核输出是特别有用的线索来源，别扔了它们。

提供——版本号。程序的版本、操做系统的版本以及与问题有关的程序的版本。

果程序员不知道您说的是什么意思，那您就跟没说同样。

信息宁多毋少！若是您说了不少，程序员能够略去一部分，但是若是您说的太少，他们就不得不回过头再去问您一些问题。有一次我收到了一份bug报告只有一句话，每一次我问他更多事情时，他每次的回复都是一句话，因而我花了几个星期的时间才获得了有用的信息。

• 慎用代词。诸如“它”，“窗体”这些词，当它们指代不清晰的时候不要用。来看看这句话：“我运行了FooApp，它弹出一个警告窗口，我试着关掉它，它就崩溃了。”这种表述并不清晰，用户究竟关掉了哪一个窗口？是警告窗口仍是整个FooApp程序？您能够这样说，“我运行FooApp程序时弹出一个警告窗口，我试着关闭警告窗口，FooApp崩溃了。”这样虽然罗嗦点，可是很清晰不容易产生误解。

检查 。从新读一遍您写的bug报告， 您 以为它是否清晰？若是您列出了一系列能致使程序出错的操做，那么照着作一遍，看看您是否是漏写了一步。

最重要的是要作到 精确 。程序员喜欢精确。若是作相同的事情有两种方法，请说明您用的是哪种。例如：“我选择了‘载入’”，可能意味着“我用鼠标点击‘载入’”或“我按下了‘ALT+L’”，说清楚您用了哪一种方法