（摘自Bugzilla）Bug 回報寫作技巧

来源：互联网发布：syma fpv软件下载编辑：程序博客网时间：2024/06/05 17:01

有效率的 bug 回報可以讓 bug 較容易被修復。以下解釋如何寫出此類回報。

原則

正確
清晰－－適當解釋，讓他人可以重製該 bug
每份報告只回報一個 bug
即使是微小的 bug 也應該回報－－小的 bug 背後可能隱藏著大的 bug
陳述事實而不猜測

事前準備

以最新 build 的軟體試著重製你遇到的 bug ，看此問題是否已修正。
搜尋 Bugzilla 看看你遇到的 bug 是否已有人回報。

回報一個新的 Bug

如果你已在最新的 build 重製出這個 bug 而且還沒有人回報，那麼：

點選「輸入新的 bug 」
選擇在哪個產品遇到這個 bug
填表。以下是一些有助瞭解表格內容的說明：

子產品：這個 bug 屬於軟體的哪個部份？
此欄位為必填。點選「子產品」可以看見每項子產品的描述。如果沒有適當的子產品，試著尋找「一般」子產品。

作業系統：在哪個作業系統發現的？（例如 Linux 、 Windows XP 、 Mac OS X 。）
如果你知道這個 bug 會發生在多種作業系統，選擇全部 (All) 。如果你的作業系統不在清單上，選擇其他 (Other) 。

摘要：你如何以少於 60 個字元的長度，來描述這個 bug ？
一個好的摘要應該能夠快速並獨一無二地識別 bug 的回報。 它應該要解釋問題所在點，而非提供解決方法。

好的例子：「取消複製檔案的對話框時，檔案總管當掉」
不好的例子：「軟體當掉」
不好的例子：「瀏覽器應該要可以瀏覽我的網頁」

描述： 問題回報的細節，包括：

概觀：對於摘要做更詳細的描述。
在 NSGetFactory 功能下拖拉任何頁面，會使 Mac build 當掉。
重製步驟： 可以簡單重製 bug 的步驟。包括任何特別的設定步驟。
1) 瀏覽任何網頁。（我用了預設的範本頁面， resource:/res/samples/test0.html ）

2) 拖拉該頁。（特別是當按住滑鼠按鍵時，將滑鼠游標從瀏覽器內容區的任一點拖至瀏覽器內容區的底部。）
實際結果：在上述步驟後，程式的實際結果。
應用程式當了。
預期結果：如果沒有 bug 的話，程式預期的結果。
視窗應該往下拉。下拉的內容應該被選取。（至少應用程式不應該當掉。）
build 日期以及硬體平台：第一次遇到這個 bug 時，硬體平台的 build 以及日期。
Build 2006-08-10 的 Mac OS 10.4.3
額外的 build 以及硬體平台：在其他的硬體平台（或瀏覽器）是否會發生這個 bug 。
不會在 build 2006-08-10 的 Windows XP Home (Service Pack 2) 上發生
附加資訊：其他有用的資訊。

對於會造成當掉的 bug ：
Windows ：註明當掉的種類，以及應用程式在哪種模組下當掉換（例如：在 apprunner.exe 中拒絕存取。）
Mac OS X ：附上 "Crash Reporter" 的記錄檔。只要附上 "Thread 0 Crashed" 的段落即可。請勿貼上整份記錄檔！

檢查報告內容是否正確，然後點選「送出」，就可以將你回報的 bug 放進 Bugzilla 資料庫裡了。