Bug剖析

? 所有的Bug報(bào)告有以下的基本要求：
? 標(biāo)題。要簡(jiǎn)略。
? 指派。誰(shuí)來(lái)處理這個(gè)問(wèn)題。
? 重現(xiàn)步驟。問(wèn)題再次出現(xiàn)的相關(guān)步驟。
? 優(yōu)先級(jí)別。問(wèn)題的緊迫性與重要性。
? 嚴(yán)重程度。問(wèn)題所產(chǎn)生的后果。
? 解決方案。怎么解決問(wèn)題。
其他很多方面對(duì)修復(fù)問(wèn)題及明白其深層次原因也很有幫助，但以上基本準(zhǔn)則簡(jiǎn)練得多。下面我們來(lái)對(duì)每條準(zhǔn)則逐一展開(kāi)討論，消除這些疑惑。

標(biāo)題及指派

標(biāo)題應(yīng)該簡(jiǎn)明扼要，一句話就詳盡說(shuō)明問(wèn)題的唯一性，使Bug報(bào)告的檢索及標(biāo)識(shí)變得簡(jiǎn)單?！包c(diǎn)擊取消按鈕，屏幕就清空了”是個(gè)差勁的標(biāo)題?！瓣P(guān)閉編輯框，清空屏幕”就是個(gè)很好的標(biāo)題。后者簡(jiǎn)短得多，而且對(duì)問(wèn)題的出處及發(fā)生時(shí)間提供了具體的信息。
當(dāng)你要?jiǎng)?chuàng)建一份新的Bug報(bào)告時(shí)，你必須指定具體人選來(lái)解決其中問(wèn)題。但是，即使你這個(gè)團(tuán)隊(duì)的每個(gè)人都很了解，你也不應(yīng)該將一個(gè)Bug指定給其中某一位，除非你是開(kāi)發(fā)團(tuán)隊(duì)的一員。相反，你應(yīng)該將此任務(wù)交給這整個(gè)團(tuán)隊(duì)。通常的做法是在Bug報(bào)告中指定責(zé)任方或團(tuán)隊(duì)作為默認(rèn)選擇。默認(rèn)的選擇通常是“主導(dǎo)”或“會(huì)診”團(tuán)隊(duì)。不會(huì)再有更好的了。要相信這些團(tuán)隊(duì)，他們會(huì)知道問(wèn)題由誰(shuí)來(lái)解決。
作者注：有些團(tuán)隊(duì)希望將所有Bug都指派給團(tuán)隊(duì)中的某些個(gè)人，這樣可保證沒(méi)有Bug被遺漏。但是，他們還是必須確認(rèn)將Bug指派給“主導(dǎo)”或“會(huì)診”團(tuán)隊(duì)以確保Bug未被遺漏。畢竟，團(tuán)隊(duì)外部人員并不知道軟件還有其他什么功能。
作為慣例，所有Bug必須指派給能對(duì)其進(jìn)行經(jīng)常性檢查的個(gè)人或團(tuán)隊(duì)。因?yàn)?#xff0c;大多數(shù)優(yōu)先團(tuán)隊(duì)會(huì)每天開(kāi)例會(huì)，我還是偏好將Bug指定給“主導(dǎo)”或“會(huì)診”團(tuán)隊(duì)為默認(rèn)選擇。

重現(xiàn)步驟

沒(méi)什么比一份Bug報(bào)告沒(méi)有清晰的重現(xiàn)步驟更讓人郁悶了。就像你的親友對(duì)你說(shuō)：“你知道該怎么辦！”，沒(méi)有給你更多解釋。這讓我很茫然，不知道怎么辦。悲催了。
Bug重現(xiàn)步驟應(yīng)是言簡(jiǎn)意賅——一言中的。同時(shí)要包含軟件創(chuàng)建編號(hào)（通常是單獨(dú)列出的），你的工作環(huán)境（操作系統(tǒng)版本、所用瀏覽器及其他相關(guān)的細(xì)節(jié)）以及一些先備條件（像先注冊(cè)個(gè)Xboxcom金牌賬號(hào)等）。
有時(shí)你不能確定Bug是怎么發(fā)生的，因?yàn)樗袝r(shí)是間歇性的或跟某種特定的狀態(tài)相關(guān)。這種情況下，列出創(chuàng)建編號(hào)、運(yùn)行環(huán)境及配置等信息，接著描述下當(dāng)時(shí)的情況，以說(shuō)明具體的Bug重現(xiàn)步驟無(wú)法確定。

注：我們有些內(nèi)部工具，如Watson與Autobug，它們可以自動(dòng)生成Bug報(bào)告。誠(chéng)然，用這些工具生成Bug重現(xiàn)步驟有其局限性，但是它們通常仍可以提供些堆棧跟蹤信息、創(chuàng)建編號(hào)、環(huán)境及其他相關(guān)的信息，且它們對(duì)隔離問(wèn)題有幫助。

在簡(jiǎn)潔的Bug重現(xiàn)描述后，你必須指出什么是你希望發(fā)生的（“期望”），及事實(shí)發(fā)生了什么（“事實(shí)”）。所有的重現(xiàn)步驟包括這三方面——配置、期望結(jié)果及實(shí)際結(jié)果。這樣當(dāng)別人在看這份Bug報(bào)告時(shí)就知道到底哪里出錯(cuò)了及怎么重現(xiàn)它。
通常一張圖、一段視頻頂上千句文字，有很多工具可以對(duì)屏幕進(jìn)行圖片及視頻抓取。將這些文件附到Bug報(bào)告中，這些文件就是一份能妥善修復(fù)Bug的報(bào)告與含糊不清的報(bào)告之間的區(qū)別。
作者注：如果一個(gè)問(wèn)題可以用4個(gè)步驟講清楚而你在Bug報(bào)告里卻用了15個(gè)步驟，這是讓人相當(dāng)惱火的。不僅僅是因?yàn)?步很簡(jiǎn)單，容易理解，而且這樣可以使開(kāi)發(fā)者及測(cè)試者快速找到Bug。重現(xiàn)Bug用的時(shí)間越少，在確認(rèn)Bug的原因上所花時(shí)間也越少（可能出現(xiàn)Bug的步驟少了），同樣在確認(rèn)Bug已被修復(fù)上所用的時(shí)間也越少。

優(yōu)先級(jí)別

對(duì)于優(yōu)先級(jí)別意義的討論一直沒(méi)完沒(méi)了，這種級(jí)別的范圍值通常為0～3。說(shuō)實(shí)在的，你可以把時(shí)間更好地用到其他地方去。這里還是說(shuō)些簡(jiǎn)單的準(zhǔn)則，以此為基礎(chǔ)闡明優(yōu)先級(jí)別。
? 優(yōu)先級(jí)別一旦設(shè)定則不宜再改，除非Bug本身角色變換了。如果級(jí)別1意味著：“在目前的沖刺階段或里程碑期間修復(fù)”，級(jí)別2意味著：“到下一個(gè)沖刺階段或里程碑期間再修復(fù)，”那么在每個(gè)沖刺結(jié)束時(shí)，你必須更新Bug的優(yōu)先級(jí)別，這樣不僅很浪費(fèi)時(shí)間，而且改變了Bug的“最后一次變更時(shí)間”，這會(huì)喪失很多重要信息。
? 優(yōu)先級(jí)別必須容易指定并區(qū)分。你不會(huì)想讓你的團(tuán)隊(duì)花大量的時(shí)間爭(zhēng)論每一個(gè)Bug的優(yōu)先級(jí)別吧。它必須是顯而易見(jiàn)的，不管是在寫B(tài)ug報(bào)告或讀Bug報(bào)告的時(shí)候。
? 優(yōu)先級(jí)別必須易記且易操作。人們不需要問(wèn)：“下一個(gè)Pri 2是什么？”，人們也不需要問(wèn)哪種級(jí)別需要做什么。
基于以上三條準(zhǔn)則，一般普遍接受以下優(yōu)先級(jí)別的定義。

Pri 0 一個(gè)需引起嚴(yán)重關(guān)注的致命錯(cuò)誤。不存在變通辦法，是一個(gè)不可逾越的Bug 只有解決了這個(gè)問(wèn)題或找到了變通辦法，你才能安心 Pri
1 一個(gè)需引起嚴(yán)重關(guān)注的致命錯(cuò)誤 必須在當(dāng)前的沖刺階段或里程碑期間解決 Pri 2 一個(gè)嚴(yán)重的錯(cuò)誤 必須在產(chǎn)品發(fā)布前解決 Pri
3 一般性錯(cuò)誤或建議 最好在產(chǎn)品發(fā)布前解決 Pri
0通常有礙測(cè)試、部署或其他對(duì)時(shí)間敏感的工作。你必須給開(kāi)發(fā)者或團(tuán)隊(duì)發(fā)郵件并電話告知他們，或者直接過(guò)去跟他們談，直到有人解決這個(gè)問(wèn)題。如果有變通辦法，Pri
0就必須改成Pri 1。

注：確實(shí)有開(kāi)發(fā)團(tuán)隊(duì)對(duì)優(yōu)先級(jí)別有非常多的定義。有的從Pri 1開(kāi)始，而不是Pri 0；有的不遵從我在本章開(kāi)始時(shí)列出的準(zhǔn)則，或者在一個(gè)單獨(dú)的區(qū)域提示Bug信息。
如果你查看另一個(gè)團(tuán)隊(duì)的工作項(xiàng)目數(shù)據(jù)庫(kù)，確定你使用的是他們的定義。這些定義通常顯示在工具提示上或幫助窗口中。

嚴(yán)重程度

嚴(yán)重程度比優(yōu)先級(jí)別簡(jiǎn)單得多，但是它還是經(jīng)常被搞混。嚴(yán)重程度指的是問(wèn)題所產(chǎn)生的影響范圍，不關(guān)乎“有多么嚴(yán)重”這樣的問(wèn)題。其定義是：

? 嚴(yán)重程度1。某問(wèn)題引起系統(tǒng)崩潰或客戶數(shù)據(jù)丟失。
? 嚴(yán)重程度2。某問(wèn)題引起的故障阻斷了后續(xù)操作。
? 嚴(yán)重程度3。某問(wèn)題引起操作不便或界面顯示不完整。
注意，嚴(yán)重程度與優(yōu)先級(jí)別是相互獨(dú)立的——換句話說(shuō)，嚴(yán)重程度與優(yōu)先級(jí)別毫無(wú)關(guān)系。優(yōu)先級(jí)別1的Bug比級(jí)別2的Bug更重要，不管其嚴(yán)重程度如何。顯示一些不合適的內(nèi)容就是嚴(yán)重程度3但也可能是優(yōu)先級(jí)別1；系統(tǒng)崩潰后用戶強(qiáng)行重啟就是嚴(yán)重程度1同時(shí)也可能是優(yōu)先級(jí)別3。工程師聲稱一個(gè)未致系統(tǒng)崩潰的Bug的嚴(yán)重程度是1，因?yàn)閲?yán)重程度很高。你完全沒(méi)必要成為他戲弄的笑料。如果你這樣就白癡了。

解決方案

Bug報(bào)告中最重要且經(jīng)常被混淆的部分是“解決方案”——說(shuō)明如何解決問(wèn)題。解決了一個(gè)Bug意味著你不再關(guān)心這個(gè)問(wèn)題。當(dāng)Bug的發(fā)現(xiàn)者確認(rèn)這個(gè)方案能修復(fù)這個(gè)Bug時(shí)，你也不打算再作更多的處理。
在你發(fā)布產(chǎn)品前，如果對(duì)一個(gè)問(wèn)題需要做更多的處理，即使這不是你的團(tuán)隊(duì)的責(zé)任，那這個(gè)Bug還是要引起關(guān)注，并指定你團(tuán)隊(duì)里的一個(gè)人繼續(xù)跟蹤相關(guān)事宜。

以下是解決方案部分可能包含的內(nèi)容：

? 意圖。Bug報(bào)告描述了所需處理的細(xì)節(jié)，按預(yù)先意圖進(jìn)行。
? 重復(fù)。這個(gè)Bug與報(bào)告中先前指出的Bug有相同的起因及非常相似的用戶體驗(yàn)。不要像分析一個(gè)舊Bug一樣分析新Bug——不管這個(gè)新的Bug報(bào)告看起來(lái)會(huì)多精美，除非你想與Bug發(fā)現(xiàn)人為敵并喪失“首先發(fā)現(xiàn)Bug”的機(jī)會(huì)。
? 外部性。一個(gè)Bug是由你控制能力之外的原因引起的，則你可以在Bug未修復(fù)之前發(fā)布產(chǎn)品。如果你團(tuán)隊(duì)之外的人沒(méi)有修復(fù)這個(gè)問(wèn)題，使你的產(chǎn)品發(fā)布不了，那么保持對(duì)這個(gè)Bug的關(guān)注并指定你團(tuán)隊(duì)里的某人進(jìn)行跟蹤，找到其他團(tuán)隊(duì)中存在的問(wèn)題。
? 已修復(fù)。Bug修復(fù)了。這是我最喜愛(ài)的解決方案。
? 不再發(fā)生。你不能讓Bug在之前說(shuō)過(guò)的創(chuàng)建版本及環(huán)境中再次發(fā)生。聲稱“在我的機(jī)子上運(yùn)行沒(méi)什么問(wèn)題”并不代表Bug解除了——隨時(shí)與Bug發(fā)現(xiàn)人保持溝通。
? 延期。你不想在這個(gè)版本中修復(fù)Bug。延期是偷懶者的借口，他們總說(shuō)明天我會(huì)寫個(gè)測(cè)試單元。真正的工程師會(huì)時(shí)刻關(guān)注這個(gè)Bug并會(huì)在Bug報(bào)告里留出一個(gè)“等待修復(fù)”專區(qū)來(lái)指出下一個(gè)改進(jìn)版本，只要他們真的想修復(fù)這個(gè)問(wèn)題。
? 不修復(fù)。你不再修復(fù)Bug。這是我第二種得意的解決方法——這說(shuō)明你有豐富的經(jīng)驗(yàn)判知哪些Bug不需要修復(fù)。通常是因?yàn)樾迯?fù)本身會(huì)帶來(lái)比Bug更多的問(wèn)題。
當(dāng)你在解決一個(gè)Bug時(shí)，你必須在解決方案中有段描述。這段描述是很重要的。這樣可使解決方案少些爭(zhēng)論，Bug重現(xiàn)時(shí)就更易理解，使你與你的公司免于因?yàn)檫@個(gè)問(wèn)題成了公眾熱議的話題。這在我之前的一個(gè)團(tuán)隊(duì)中曾發(fā)生過(guò)——我們使這個(gè)公司免于千夫所指，因?yàn)槲覀兊慕鉀Q方案中對(duì)一個(gè)出現(xiàn)不合適內(nèi)容的Bug作了描述，以說(shuō)明我們并非蓄意而為。

當(dāng)一個(gè)Bug被解決，它將被自行指派給發(fā)現(xiàn)它的人。如果這個(gè)人不是開(kāi)發(fā)團(tuán)隊(duì)的人員，那這個(gè)Bug必須指定給另一個(gè)團(tuán)隊(duì)中的人，這個(gè)人可以跟Bug發(fā)現(xiàn)者核實(shí)解決方案。但你不能總是指望團(tuán)隊(duì)外部的人能及時(shí)周到地確認(rèn)解決方案。當(dāng)然，如果這個(gè)解決方案不怎么令人滿意，那么這個(gè)Bug應(yīng)被重新激活。

過(guò)猶不及

Bug報(bào)告中還有很多其他區(qū)域。我說(shuō)過(guò)用“創(chuàng)建”及“環(huán)境”兩個(gè)區(qū)域記錄Bug相關(guān)信息以及用“等待修復(fù)”區(qū)域來(lái)說(shuō)明什么時(shí)候處理Bug。還有一些區(qū)域用來(lái)跟蹤記錄底層原因，這個(gè)Bug是怎么被發(fā)現(xiàn)的，Bug是在產(chǎn)品或服務(wù)的哪個(gè)方面發(fā)生的，潛在的安全威脅以及其他信息。

設(shè)定好Bug報(bào)告的必要條件，少則缺，多則無(wú)益。要求太多人們會(huì)怨聲四起而拒絕完成Bug報(bào)告——兩種極端都會(huì)對(duì)你及你的客戶不利。

Bug報(bào)告要易寫且易讀，這樣會(huì)促使他們?cè)诎l(fā)現(xiàn)問(wèn)題的時(shí)候制定清晰的Bug報(bào)告。使用一些Bug模板對(duì)于一些內(nèi)容的編寫是很有幫助的。對(duì)于我們?cè)诤醯墓こ處熂翱蛻魜?lái)說(shuō)，規(guī)范的Bug報(bào)告使一個(gè)問(wèn)題在用戶發(fā)現(xiàn)前消滅于萌芽狀態(tài)，沒(méi)有比這更好的禮物了。