如何有效地報告 Bug

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

我很是但願每個人在報告bug以前都讀一下這篇短文，

您能夠親自示範，也能夠給出能致使程序出錯的、詳盡的操做步驟。

若是程序附帶了一套報告bug的準則，必定要讀。

報告bug的最好的方法之一是「演示」給程序員看。

確切地告訴程序員您作了些什麼。若是是一個圖形界面程序，告訴他們您按了哪一個按鈕，依照什麼順序按的。若是是一個命令行程序，精確的告訴他們您鍵入了什麼命令。您應該儘量詳細地提供您所鍵入的命令和程序的反應。

精確的描述您看到了什麼。告訴他們爲何您以爲本身所看到的是錯誤的，最好再告訴他們，您認爲本身應該看到什麼。若是您只是說：「程序出錯了」，那您極可能漏掉了很是重要的信息。

。只報告「程序出了一個錯」是毫無心義的

您看到了什麼，您想看到什麼，把錯誤消息記下來，若是有錯誤消息號， 必定 要把這些號碼告訴程序員。不要覺得您看不出任何意義，它就沒有意義。

程序可能會產生一個內核輸出（coredump）。內核輸出是特別有用的線索來源，別扔了它們。

提供——版本號。程序的版本、操做系統的版本以及與問題有關的程序的版本。

果程序員不知道您說的是什麼意思，那您就跟沒說同樣。

信息寧多毋少！若是您說了不少，程序員能夠略去一部分，但是若是您說的太少，他們就不得不回過頭再去問您一些問題。有一次我收到了一份bug報告只有一句話，每一次我問他更多事情時，他每次的回覆都是一句話，因而我花了幾個星期的時間才獲得了有用的信息。

• 慎用代詞。諸如「它」，「窗體」這些詞，當它們指代不清晰的時候不要用。來看看這句話：「我運行了FooApp，它彈出一個警告窗口，我試着關掉它，它就崩潰了。」這種表述並不清晰，用戶究竟關掉了哪一個窗口？是警告窗口仍是整個FooApp程序？您能夠這樣說，「我運行FooApp程序時彈出一個警告窗口，我試着關閉警告窗口，FooApp崩潰了。」這樣雖然羅嗦點，可是很清晰不容易產生誤解。

檢查 。從新讀一遍您寫的bug報告， 您 以爲它是否清晰？若是您列出了一系列能致使程序出錯的操做，那麼照着作一遍，看看您是否是漏寫了一步。

最重要的是要作到 精確 。程序員喜歡精確。若是作相同的事情有兩種方法，請說明您用的是哪種。例如：「我選擇了‘載入’」，可能意味着「我用鼠標點擊‘載入’」或「我按下了‘ALT+L’」，說清楚您用了哪一種方法