讀了一個(gè)小冊(cè)子：《提問的智慧》
提問的智慧
--------------------------------------------------------------------------------
經(jīng)典文章，必看
Copyright (C) 2001 by Eric S. Raymond
中文版 Copyleft 2001 by D.H.Grand(nOBODY/Ginux)
英文版：http://www.tuxedo.org/~esr/faqs/smart-questions.html
感謝 Eric 的耐心指點(diǎn)和同意，本文才得以完成并發(fā)布，
本指南英文版版權(quán)為 Eric Steven Raymond 所有，
中文版版權(quán)由 D.H.Grand[nOBODY/Ginux] 所有。
在黑客世界里，當(dāng)提出一個(gè)技術(shù)問題時(shí)，你能得到怎樣的回答？這取決于挖出答案的難度，同樣取決于你提問的方法。本指南旨在幫助你提高發(fā)問技巧，以獲取你最想要的答案。
首先你必須明白，黑客們只偏愛艱巨的任務(wù)，或者能激發(fā)他們思維的好問題。 如若不然，我們還來干嗎？如果你有值得我們反復(fù)咀嚼玩味的好問題，我們自會(huì)對(duì)你感激不盡。好問題是激勵(lì)，是厚禮，可以提高我們的理解力，而且通常會(huì)暴露我們以前從沒意識(shí)到或者思考過的問題。對(duì)黑客而言，“問得好！”是發(fā)自內(nèi)心的大力稱贊。
盡管黑客們有蔑視簡(jiǎn)單問題和不友善的壞名聲，有時(shí)看起來似乎我們對(duì)新手，對(duì)知識(shí)貧乏者懷有敵意，但其實(shí)不是那樣的。
我們不想掩飾對(duì)這樣一些人的蔑視--他們不愿思考，或者在發(fā)問前不去完成他們應(yīng)該做的事。這種人只會(huì)謀殺時(shí)間--他們只愿索取，從不付出，無端消耗我們的時(shí)間，而我們本可以把時(shí)間用在更有趣的問題或者更值得回答的人身上。 我們稱這樣的人為“失敗者”（由于歷史原因，我們有時(shí)把它拼作“l(fā)users”）。
我們?cè)诤艽蟪潭壬蠈儆谥驹刚撸瑥姆泵Φ纳钪谐槌鰰r(shí)間來解惑答疑，而且時(shí)常被提問淹沒。所以我們無情的濾掉一些話題，特別是拋棄那些看起來象失敗者的家伙，以便更高效的利用時(shí)間來回答勝利者的問題。
如果你覺得我們過于傲慢的態(tài)度讓你不爽，讓你委屈，不妨設(shè)身處地想想。我們并沒有要求你向我們屈服--事實(shí)上，我們中的大多數(shù)人最喜歡公平交易不過了，只要你付出小小努力來滿足最起碼的要求，我們就會(huì)歡迎你加入到我們的文化中來。但讓我們幫助那些不愿意幫助自己的人是沒有意義的。如果你不能接受這種“歧視”，我們建議你花點(diǎn)錢找家商業(yè)公司簽個(gè)技術(shù)支持協(xié)議得了，別向黑客乞求幫助。
如果你決定向我們求助，當(dāng)然不希望被視為失敗者，更不愿成為失敗者中的一員。立刻得到有效答案的最好方法，就是象勝利者那樣提問 —— 聰明、自信、有解決問題的思路，只是偶爾在特定的問題上需要獲得一點(diǎn)幫助。
（歡迎對(duì)本指南提出改進(jìn)意見。任何建議請(qǐng)E-mail至esr@thyrsus.com，然而請(qǐng)注意，本文并非網(wǎng)絡(luò)禮節(jié)的通用指南，我通常會(huì)拒絕無助于在技術(shù)論壇得到有用答案的建議。） （當(dāng)然，如果你寫中文，最好還是寄DHGrand@hotmail.com;-）
= 提問之前 =
在通過電郵、新聞組或者聊天室提出技術(shù)問題前，檢查你有沒有做到：
1. 通讀手冊(cè)，試著自己找答案。
2. 在FAQ里找答案（一份維護(hù)得好的FAQ可以包羅萬象:）。
3. 在網(wǎng)上搜索（個(gè)人推薦google~~~）。
4. 向你身邊精于此道的朋友打聽。
當(dāng)你提出問題的時(shí)候，首先要說明在此之前你干了些什么；這將有助于樹立你的形象：你不是一個(gè)妄圖不勞而獲的乞討者，不愿浪費(fèi)別人的時(shí)間。如果提問者能從答案中學(xué)到東西，我們更樂于回答他的問題。
周全的思考，準(zhǔn)備好你的問題，草率的發(fā)問只能得到草率的回答，或者根本得不到任何答案。越表現(xiàn)出在尋求幫助前為解決問題付出的努力，你越能得到實(shí)質(zhì)性的幫助。
小心別問錯(cuò)了問題。如果你的問題基于錯(cuò)誤的假設(shè)，普通黑客（J. Random Hacker）通常會(huì)用無意義的字面解釋來答復(fù)你，心里想著“蠢問題...”，希望著你會(huì)從問題的回答（而非你想得到的答案）中汲取教訓(xùn)。
決不要自以為夠資格得到答案，你沒這種資格。畢竟你沒有為這種服務(wù)支付任何報(bào)酬。你要自己去“掙”回一個(gè)答案，靠提出一個(gè)有內(nèi)涵的，有趣的，有思維激勵(lì)作用的問題--一個(gè)對(duì)社區(qū)的經(jīng)驗(yàn)有潛在貢獻(xiàn)的問題，而不僅僅是被動(dòng)的從他人處索要知識(shí)--去掙到這個(gè)答案。
另一方面，表明你愿意在找答案的過程中做點(diǎn)什么，是一個(gè)非常好的開端。“誰能給點(diǎn)提示？”、“我這個(gè)例子里缺了什么？”以及“我應(yīng)該檢查什么地方？”比“請(qǐng)把確切的過程貼出來”更容易得到答復(fù)。因?yàn)槟泔@得只要有人指點(diǎn)正確的方向，你就有完成它的能力和決心。
= 怎樣提問 =
- 謹(jǐn)慎選擇論壇
小心選擇提問的場(chǎng)合。如果象下面描述的那樣，你很可能被忽略掉或者被看作失敗者：
1. 在風(fēng)馬牛不相及的論壇貼出你的問題
2. 在探討高級(jí)技巧的論壇張貼非常初級(jí)的問題；反之亦然
3. 在太多的不同新聞組交叉張貼
- 用辭貼切，語法正確，拼寫無誤
我們從經(jīng)驗(yàn)中發(fā)現(xiàn)，粗心的寫作者通常也是馬虎的思考者（我敢打包票）。 回答粗心大意者的問題很不值得，我們寧愿把時(shí)間耗在別處。
正確的拼寫，標(biāo)點(diǎn)符號(hào)和大小寫很重要。
更一般的說，如果你的提問寫得象個(gè)半文盲，你很有可能被忽視。
如果你在使用非母語的論壇提問，你可以犯點(diǎn)拼寫和語法上的小錯(cuò)--但決不能在思考上馬虎（沒錯(cuò)，我們能弄清兩者的分別） 。
- 使用含義豐富，描述準(zhǔn)確的標(biāo)題
在郵件列表或者新聞組中，大約50字以內(nèi)的主題標(biāo)題是抓住資深專家注意力的黃金時(shí)機(jī)。別用喋喋不休的“幫幫忙”（更別說“救命啊！！！！！”這樣讓人反感的話）來浪費(fèi)這個(gè)機(jī)會(huì)。不要妄想用你的痛苦程度來打動(dòng)我們， 別用空格代替問題的描述，哪怕是極其簡(jiǎn)短的描述。
蠢問題： 救命啊！我的膝上機(jī)不能正常顯示了！
聰明問題： XFree86 4.1下鼠標(biāo)光標(biāo)變形，F(xiàn)ooware MV1005的顯示芯片。
如果你在回復(fù)中提出問題，記得要修改內(nèi)容標(biāo)題，表明里面有一個(gè)問題。一個(gè)看起來象“Re：測(cè)試”或者“Re：新bug”的問題很難引起足夠重視。另外，引用并刪減前文的內(nèi)容，給新來的讀者留下線索。
- 精確描述，信息量大
1. 謹(jǐn)慎明確的描述癥狀。
2. 提供問題發(fā)生的環(huán)境（機(jī)器配置、操作系統(tǒng)、應(yīng)用程序以及別的什么）。
3. 說明你在提問前是怎樣去研究和理解這個(gè)問題的。
4. 說明你在提問前采取了什么步驟去解決它。
5. 羅列最近做過什么可能有影響的硬件、軟件變更。
盡量想象一個(gè)黑客會(huì)怎樣反問你，在提問的時(shí)候預(yù)先給他答案。
Simon Tatham寫過一篇名為《如何有效的報(bào)告Bug》的出色短文。強(qiáng)力推薦你也讀一讀。
- 話不在多
你需要提供精確有效的信息。這并不是要求你簡(jiǎn)單的把成噸的出錯(cuò)代碼或者數(shù)據(jù)完全轉(zhuǎn)儲(chǔ)摘錄到你的提問中。如果你有龐大而復(fù)雜的測(cè)試條件，盡量把它剪裁得越小越好。
這樣做的用處至少有三點(diǎn)。第一，表現(xiàn)出你為簡(jiǎn)化問題付出了努力，這可以使你得到回答的機(jī)會(huì)增加；第二，簡(jiǎn)化問題使你得到有用答案的機(jī)會(huì)增加；第三，在提煉你的bug報(bào)告的過程中，也許你自己就能找出問題所在或作出更正。
- 只說癥狀，不說猜想
告訴黑客們你認(rèn)為問題是怎樣引起的沒什么幫助。（如果你的推斷如此有效，還用向別人求助嗎？），因此要確信你原原本本告訴了他們問題的癥狀，不要加進(jìn)你自己的理解和推論。讓黑客們來診斷吧。
蠢問題： 我在內(nèi)核編譯中一次又一次遇到SIG11錯(cuò)誤，我懷疑某條飛線搭在主板的走線上了，這種情況應(yīng)該怎樣檢查最好？
聰明問題： 我自制的一套K6/233系統(tǒng)，主板是FIC-PA2007 （VIA Apollo VP2芯片組），256MB Corsair PC133 SDRAM，在內(nèi)核編譯中頻頻產(chǎn)生SIG11錯(cuò)誤，從開機(jī)20分鐘以后就有這種情況，開機(jī)前20分鐘內(nèi)從沒發(fā)生過。重啟也沒有用，但是關(guān)機(jī)一晚上就又能工作20分鐘。所有內(nèi)存都換過了，沒有效果。相關(guān)部分的典型編譯記錄如下...。
- 按時(shí)間順序列出癥狀
對(duì)找出問題最有幫助的線索，往往就是問題發(fā)生前的一系列操作，因此，你的說明應(yīng)該包含操作步驟，以及電腦的反應(yīng)，直到問題產(chǎn)生。
如果你的說明很長（超過四個(gè)段落），在開頭簡(jiǎn)述問題會(huì)有所幫助，接下來按時(shí)間順序詳述。這樣黑客們就知道該在你的說明中找什么。
- 明白你想問什么
漫無邊際的提問近乎無休無止的時(shí)間黑洞。最能給你有用答案的人也正是最忙的人（他們忙是因?yàn)橐H自完成大部分工作）。這樣的人對(duì)無節(jié)制的時(shí)間黑洞不太感冒，因此也可以說他們對(duì)漫無邊際的提問不大感冒。
如果你明確表述需要回答者做什么（提供建議，發(fā)送一段代碼，檢查你的補(bǔ)丁或是別的），就最有可能得到有用的答案。這會(huì)定出一個(gè)時(shí)間和精力的上限，便于回答者集中精力來幫你，這很奏效。要理解專家們生活的世界，要把專業(yè)技能想象為充裕的資源，而回復(fù)的時(shí)間則是貧乏的資源。解決你的問題需要的時(shí)間越少，越能從忙碌的專家口中掏出答案。
因此，優(yōu)化問題的結(jié)構(gòu)，盡量減少專家們解決它所需要的時(shí)間，會(huì)有很大的幫助--這通常和簡(jiǎn)化問題有所區(qū)別。因此，問“我想更好的理解X，能給點(diǎn)提示嗎？”通常比問“你能解釋一下X嗎？”更好。如果你的代碼不能工作，問問它有什么地方不對(duì)，比要求別人替你修改要明智得多。
- 別問應(yīng)該自己解決的問題
黑客們總是善于分辨哪些問題應(yīng)該由你自己解決；因?yàn)槲覀冎械拇蠖鄶?shù)都曾自己解決這類問題。同樣，這些問題得由你來搞定，你會(huì)從中學(xué)到東西。你可以要求給點(diǎn)提示，但別要求得到完整的解決方案。
- 去除無意義的疑問
別用無意義的話結(jié)束提問，例如“有人能幫我嗎？”或者“有答案嗎？”。 首先：如果你對(duì)問題的描述不很合適，這樣問更是畫蛇添足。其次：由于這樣問是畫蛇添足，黑客們會(huì)很厭煩你--而且通常會(huì)用邏輯上正確的回答來表示他們的蔑視，例如：“沒錯(cuò)，有人能幫你”或者“不，沒答案”。
- 謙遜絕沒有害處，而且常幫大忙
彬彬有禮，多用“請(qǐng)”和“先道個(gè)謝了”。讓大家都知道你對(duì)他們花費(fèi)時(shí)間義務(wù)提供幫助心存感激。然而，如果你有很多問題無法解決，禮貌將會(huì)增加你得到有用答案的機(jī)會(huì)。
（我們注意到，自從本指南發(fā)布后，從資深黑客處得到的唯一嚴(yán)重缺陷反饋，就是對(duì)預(yù)先道謝這一條。一些黑客覺得“先謝了”的言外之意是過后就不會(huì)再感謝任何人了。我們的建議是：都道謝。）
- 問題解決后，加個(gè)簡(jiǎn)短說明
問題解決后，向所有幫助過你的人發(fā)個(gè)說明，讓他們知道問題是怎樣解決的，并再一次向他們表示感謝。如果問題在新聞組或者郵件列表中引起了廣泛關(guān)注，應(yīng)該在那里貼一個(gè)補(bǔ)充說明。補(bǔ)充說明不必很長或是很深入；簡(jiǎn)單的一句“你好，原來是網(wǎng)線出了問題！謝謝大家--Bill”比什么也不說要強(qiáng)。事實(shí)上，除非結(jié)論真的很有技術(shù)含量，否則簡(jiǎn)短可愛的小結(jié)比長篇學(xué)術(shù)論文更好。說明問題是怎樣解決的，但大可不必將解決問題的過程復(fù)述一遍。除了表示禮貌和反饋信息以外，這種補(bǔ)充有助于他人在郵件列表/新聞組/論壇中搜索對(duì)你有過幫助的完整解決方案，這可能對(duì)他們也很有用。最后（至少？），這種補(bǔ)充有助于所有提供過幫助的人從中得到滿足感。如果你自己不是老手或者黑客，那就相信我們，這種感覺對(duì)于那些你向他們求助的導(dǎo)師或者專家而言，是非常重要的。問題久拖未決會(huì)讓人灰心；黑客們渴望看到問題被解決。好人有好報(bào)，滿足他們的渴望，你會(huì)在下次貼出新問題時(shí)嘗到甜頭。
- 還是不懂
如果你不是很理解答案，別立刻要求對(duì)方解釋。象你以前試著自己解決問題時(shí)那樣（利用手冊(cè)，F(xiàn)AQ，網(wǎng)絡(luò)，身邊的高手），去理解它。如果你真的需要對(duì)方解釋，記得表現(xiàn)出你已經(jīng)學(xué)到了點(diǎn)什么。比方說，如果我回答你：“看來似乎是zEntry被阻塞了；你應(yīng)該先清除它。”，然后：一個(gè)很糟的后續(xù)問題：“zEntry是什么？” 聰明的問法應(yīng)該是這樣：“哦~~~我看過幫助了但是只有-z和-p兩個(gè)參數(shù)中提到了zEntry而且還都沒有清楚的解釋:<你是指這兩個(gè)中的哪一個(gè)嗎？還是我看漏了什么？”
=三思而后問=
以下是幾個(gè)經(jīng)典蠢問題，以及黑客在拒絕回答時(shí)的心中所想：
問題：我能在哪找到X程序？
問題：我的程序/配置/SQL申明沒有用
問題：我的Windows有問題，你能幫我嗎？
問題：我在安裝Linux（或者X）時(shí)有問題，你能幫我嗎？
問題：我怎么才能破解root帳號(hào)/竊取OP特權(quán)/讀別人的郵件呢？
提問：我能在哪找到X程序？
回答：就在我找到它的地方啊蠢貨--搜索引擎的那一頭。天吶！還有人不會(huì)用Google嗎？
提問：我的程序（配置、SQL申明）沒有用
回答：這不算是問題吧，我對(duì)找出你的真正問題沒興趣--如果要我問你二十個(gè)問題才找得出來的話--我有更有意思的事要做呢。
在看到這類問題的時(shí)候，我的反應(yīng)通常不外如下三種：
1. 你還有什么要補(bǔ)充的嗎？
2. 真糟糕，希望你能搞定。
3. 這跟我有什么鳥相關(guān)？
提問：我的Windows有問題，你能幫我嗎？
回答：能啊，扔掉萎軟的垃圾，換Linux吧。
提問：我在安裝Linux（或者X）時(shí)有問題，你能幫我嗎？
回答：不能，我只有親自在你的電腦上動(dòng)手才能找到毛病。還是去找你當(dāng)?shù)氐腖inux用戶組尋求手把手的指導(dǎo)吧（你能在這兒找到用戶組的清單）。
提問：我怎么才能破解root帳號(hào)/竊取OP特權(quán)/讀別人的郵件呢？
回答：想要這樣做，說明你是個(gè)卑鄙小人；想找個(gè)黑客幫你，說明你是個(gè)白癡！
= 好問題，壞問題 =
最后，我舉一些例子來說明，怎樣聰明的提問；同一個(gè)問題的兩種問法被放在一起，一種是愚蠢的，另一種才是明智的。
蠢問題：我可以在哪兒找到關(guān)于Foonly Flurbamatic的資料？
// 這種問法無非想得到“STFW”這樣的回答。
聰明問題：我用Google搜索過“Foonly Flurbamatic 2600”，但是沒找到有用的結(jié)果。誰知道上哪兒去找對(duì)這種設(shè)備編程的資料？
// 這個(gè)問題已經(jīng)STFW過了，看起來他真的遇到了麻煩。
蠢問題：我從FOO項(xiàng)目找來的源碼沒法編譯。它怎么這么爛？
// 他覺得都是別人的錯(cuò)，這個(gè)傲慢自大的家伙
聰明問題：FOO項(xiàng)目代碼在Nulix 6.2版下無法編譯通過。我讀過了FAQ，但里面沒有提到跟Nulix有關(guān)的問題。這是我編譯過程的記錄，我有什么做得不對(duì)的地方嗎？
// 他講明了環(huán)境，也讀過了FAQ，還指明了錯(cuò)誤，并且他沒有把問題的責(zé)任推到別人頭上，這個(gè)家伙值得留意。
蠢問題：我的主板有問題了，誰來幫我？
// 普通黑客對(duì)這類問題的回答通常是：“好的，還要幫你拍拍背和換尿布嗎？” ，然后按下刪除鍵。
聰明問題：我在S2464主板上試過了X、Y和Z，但沒什么作用，我又試了A、B和C。請(qǐng)注意當(dāng)我嘗試C時(shí)的奇怪現(xiàn)象。顯然邊帶傳輸中出現(xiàn)了收縮，但結(jié)果出人意料。在多處理器主板上引起邊帶泄漏的通常原因是什么？誰有好主意接下來我該做些什么測(cè)試才能找出問題？
// 這個(gè)家伙，從另一個(gè)角度來看，值得去回答他。他表現(xiàn)出了解決問題的能力，而不是坐等天上掉答案。
在最后一個(gè)問題中，注意“告訴我答案”和“給我啟示，指出我還應(yīng)該做什么診斷工作”之間微妙而又重要的區(qū)別。事實(shí)上，后一個(gè)問題源自于2001年8月在Linux內(nèi)核郵件列表上的一個(gè)真實(shí)的提問。我（Eric）就是那個(gè)提出問題的人。我在Tyan S2464主板上觀察到了這種無法解釋的鎖定現(xiàn)象，列表成員們提供了解決那一問題的重要信息。
通過我的提問方法，我給了大家值得玩味的東西；我讓人們很容易參與并且被吸引進(jìn)來。我顯示了自己具備和他們同等的能力，邀請(qǐng)他們與我共同探討。我告訴他們我所走過的彎路，以避免他們?cè)倮速M(fèi)時(shí)間，這是一種對(duì)他人時(shí)間價(jià)值的尊重。后來，當(dāng)我向每個(gè)人表示感謝，并且贊賞這套程序（指郵件列表中的討論 --譯者注）運(yùn)作得非常出色的時(shí)候，一個(gè)Linux內(nèi)核郵件列（lkml）成員表示，問題得到解決并非由于我是這個(gè)列表中的“名人”，而是因?yàn)槲矣昧苏_的方式來提問。我們黑客從某種角度來說是擁有豐富知識(shí)但缺乏人情味的家伙；我相信他是對(duì)的，如果我象個(gè)乞討者那樣提問，不論我是誰，一定會(huì)惹惱某些人或者被他們忽視。他建議我記下這件事，給編寫這個(gè)指南的人一些指導(dǎo)。
= 找不到答案怎么辦 =
如果仍得不到答案，請(qǐng)不要以為我們覺得無法幫助你。有時(shí)只是看到你問題的人不知道答案罷了。沒有回應(yīng)不代表你被忽視，雖然不可否認(rèn)這種差別很難區(qū)分。
總的說來，簡(jiǎn)單的重復(fù)張貼問題是個(gè)很糟的想法。這將被視為無意義的喧鬧。
你可以通過其它渠道獲得幫助，這些渠道通常更適合初學(xué)者的需要。有許多網(wǎng)上的以及本地的用戶組，由狂熱的軟件愛好者（即使他們可能從沒親自寫過任何軟件）組成。通常人們組建這樣的團(tuán)體來互相幫助并幫助新手。
另外，你可以向很多商業(yè)公司尋求幫助，不論公司大還是小（Red Hat和LinuxCare就是兩個(gè)最常見的例子）。別為要付費(fèi)才能獲得幫助而感到沮喪！畢竟，假使你的汽車發(fā)動(dòng)機(jī)汽缸密封圈爆掉了--完全可能如此--你還得把它送到修車鋪，并且為維修付費(fèi)。就算軟件沒花費(fèi)你一分錢，你也不能強(qiáng)求技術(shù)支持總是免費(fèi)的。
對(duì)大眾化的軟件，就象Linux之類而言，每個(gè)開發(fā)者至少會(huì)有上萬名用戶。根本不可能由一個(gè)人來處理來自上萬名用戶的求助電話。要知道，即使你要為幫助付費(fèi)，同你必須購買同類軟件相比，你所付出的也是微不足道的（通常封閉源代碼軟件的技術(shù)支持費(fèi)用比開放源代碼軟件要高得多，且內(nèi)容也不那么豐富）。
如何有效地報(bào)告bug！
引言
為公眾寫過軟件的人，大概都收到過很拙劣的bug（計(jì)算機(jī)程序代碼中的錯(cuò)誤或程序運(yùn)行時(shí)的瑕疵——譯者注）報(bào)告，例如：
在報(bào)告中說“不好用”；
所報(bào)告內(nèi)容毫無意義；
在報(bào)告中用戶沒有提供足夠的信息；
在報(bào)告中提供了虛假信息；
所報(bào)告的問題是由于用戶的過失而產(chǎn)生的；
所報(bào)告的問題是由于其他程序的錯(cuò)誤而產(chǎn)生的；
所報(bào)告的問題是由于網(wǎng)絡(luò)錯(cuò)誤而產(chǎn)生的；
這便是為什么“技術(shù)支持”被認(rèn)為是一件可怕的工作，因?yàn)橛凶玖拥腷ug報(bào)告需要處理。然而并不是所有的bug報(bào)告都令人生厭：我在業(yè)余時(shí)間維護(hù)自由軟件，有時(shí)我會(huì)收到非常清晰、有幫助并且內(nèi)容豐富的bug報(bào)告。
在這里我會(huì)盡力闡明如何寫一個(gè)好的bug報(bào)告。我非常希望每一個(gè)人在報(bào)告bug之前都讀一下這篇短文，當(dāng)然我也希望用戶在給我報(bào)告bug之前已經(jīng)讀過這篇文章。
簡(jiǎn)單地說，報(bào)告bug的目的是為了讓程序員看到程序的錯(cuò)誤。您可以親自示范，也可以給出能導(dǎo)致程序出錯(cuò)的、詳盡的操作步驟。如果程序出錯(cuò)了，程序員會(huì)收集額外的信息直到找到錯(cuò)誤的原因；如果程序沒有出錯(cuò)，那么他們會(huì)請(qǐng)您繼續(xù)關(guān)注這個(gè)問題，收集相關(guān)的信息。
在bug報(bào)告里，要設(shè)法搞清什么是事實(shí)（例如：“我在電腦旁”和“XX出現(xiàn)了”）什么是推測(cè)（例如：“我想問題可能是出在……”）。如果愿意的話，您可以省去推測(cè)，但是千萬別省略事實(shí)。
當(dāng)您報(bào)告bug的時(shí)候（既然您已經(jīng)這么做了），一定是希望bug得到及時(shí)修正。所以此時(shí)針對(duì)程序員的任何過激或褻瀆的言語（甚至謾罵）都是與事無補(bǔ)的——因?yàn)檫@可能是程序員的錯(cuò)誤，也有可能是您的錯(cuò)誤，也許您有權(quán)對(duì)他們發(fā)火，但是如果您能多提供一些有用的信息（而不是激憤之詞）或許bug會(huì)被更快的修正。除此以外，請(qǐng)記住：如果是免費(fèi)軟件，作者提供給我們已經(jīng)是出于好心，所以要是太多的人對(duì)他們無禮，他們可能就要“收起”這份好心了。
“程序不好用”
程序員不是弱智：如果程序一點(diǎn)都不好用，他們不可能不知道。他們不知道一定是因?yàn)槌绦蛟谒麄兛磥砉ぷ鞯煤苷！Ｋ裕蛘呤悄鬟^一些與他們不同的操作，或者是您的環(huán)境與他們不同。他們需要信息，報(bào)告bug也是為了提供信息。信息總是越多越好。
許多程序，特別是自由軟件，會(huì)公布一個(gè)“已知bug列表”。如果您找到的bug在列表里已經(jīng)有了，那就不必再報(bào)告了，但是如果您認(rèn)為自己掌握的信息比列表中的豐富，那無論如何也要與程序員聯(lián)系。您提供的信息可能會(huì)使他們更簡(jiǎn)單地修復(fù)bug。
本文中提到的都是一些指導(dǎo)方針，沒有哪一條是必須恪守的準(zhǔn)則。不同的程序員會(huì)喜歡不同形式的bug報(bào)告。如果程序附帶了一套報(bào)告bug的準(zhǔn)則，一定要讀。如果它與本文中提到的規(guī)則相抵觸，那么請(qǐng)以它為準(zhǔn)。
如果您不是報(bào)告bug，而是尋求幫助，您應(yīng)該說明您曾經(jīng)到哪里找過答案，（例如：我看了第四章和第五章的第二節(jié)，但我找不到解決的辦法。）這會(huì)使程序員了解用戶喜歡到哪里去找答案，從而使程序員把幫助文檔做得更容易使用。
“演示給我看”
報(bào)告bug的最好的方法之一是“演示”給程序員看。讓程序員站在電腦前，運(yùn)行他們的程序，指出程序的錯(cuò)誤。讓他們看著您啟動(dòng)電腦、運(yùn)行程序、如何進(jìn)行操作以及程序?qū)δ妮斎胗泻畏磻?yīng)。
他們對(duì)自己寫的軟件了如指掌，他們知道哪些地方不會(huì)出問題，而哪些地方最可能出問題。他們本能地知道應(yīng)該注意什么。在程序真的出錯(cuò)之前，他們可能已經(jīng)注意到某些地方不對(duì)勁，這些都會(huì)給他們一些線索。他們會(huì)觀察程序測(cè)試中的每一個(gè)細(xì)節(jié)，并且選出他們認(rèn)為有用的信息。
這些可能還不夠。也許他們覺得還需要更多的信息，會(huì)請(qǐng)您重復(fù)剛才的操作。他們可能在這期間需要與您交流一下，以便在他們需要的時(shí)候讓bug重新出現(xiàn)。他們可能會(huì)改變一些操作，看看這個(gè)錯(cuò)誤的產(chǎn)生是個(gè)別問題還是相關(guān)的一類問題。如果您不走運(yùn)，他們可能需要坐下來，拿出一堆開發(fā)工具，花上幾個(gè)小時(shí)研究。但是最重要的是在程序出錯(cuò)的時(shí)候讓程序員在電腦旁。一旦他們看到了問題，他們通常會(huì)找到原因并開始試著修改。
“告訴我該怎么做”
如今是網(wǎng)絡(luò)時(shí)代，是信息交流的時(shí)代。我可以點(diǎn)一下鼠標(biāo)把自己的程序送到俄羅斯的某個(gè)朋友那里，當(dāng)然他也可以用同樣簡(jiǎn)單的方法給我一些建議。但是如果我的程序出了什么問題，我不可能在他旁邊。“演示”是很好的辦法，但是常常做不到。
如果您必須報(bào)告bug，而此時(shí)程序員又不在您身邊，那么您就要想辦法讓bug重現(xiàn)在他們面前。當(dāng)他們親眼看到錯(cuò)誤時(shí)，就能夠進(jìn)行處理了。
確切地告訴程序員您做了些什么。如果是一個(gè)圖形界面程序，告訴他們您按了哪個(gè)按鈕，依照什么順序按的。如果是一個(gè)命令行程序，精確的告訴他們您鍵入了什么命令。您應(yīng)該盡可能詳細(xì)地提供您所鍵入的命令和程序的反應(yīng)。
把您能想到的所有的輸入方式都告訴程序員，如果程序要讀取一個(gè)文件，您可能需要發(fā)一個(gè)文件的拷貝給他們。如果程序需要通過網(wǎng)絡(luò)與另一臺(tái)電腦通訊，您或許不能把那臺(tái)電腦復(fù)制過去，但至少可以說一下電腦的類型和安裝了哪些軟件（如果可以的話）。
“哪兒出錯(cuò)了？在我看來一切正常哦！”
如果您給了程序員一長串輸入和指令，他們執(zhí)行以后沒有出現(xiàn)錯(cuò)誤，那是因?yàn)槟鷽]有給他們足夠的信息，可能錯(cuò)誤不是在每臺(tái)計(jì)算機(jī)上都出現(xiàn)，您的系統(tǒng)可能和他們的在某些地方不一樣。有時(shí)候程序的行為可能和您預(yù)想的不一樣，這也許是誤會(huì)，但是您會(huì)認(rèn)為程序出錯(cuò)了，程序員卻認(rèn)為這是對(duì)的。
同樣也要描述發(fā)生了什么。精確的描述您看到了什么。告訴他們?yōu)槭裁茨X得自己所看到的是錯(cuò)誤的，最好再告訴他們，您認(rèn)為自己應(yīng)該看到什么。如果您只是說：“程序出錯(cuò)了”，那您很可能漏掉了非常重要的信息。
如果您看到了錯(cuò)誤消息，一定要仔細(xì)、準(zhǔn)確的告訴程序員，它們很重要。在這種情況下，程序員只要修正錯(cuò)誤，而不用去找錯(cuò)誤。他們需要知道是什么出問題了，系統(tǒng)所報(bào)的錯(cuò)誤消息正好幫助了他們。如果您沒有更好的方法記住這些消息，就把它們寫下來。只報(bào)告“程序出了一個(gè)錯(cuò)”是毫無意義的，除非您把錯(cuò)誤消息一塊報(bào)上來。
特殊情況下，如果有錯(cuò)誤消息號(hào)，一定要把這些號(hào)碼告訴程序員。不要以為您看不出任何意義，它就沒有意義。錯(cuò)誤消息號(hào)包含了能被程序員讀懂的各種信息，并且很有可能包含重要的線索。給錯(cuò)誤消息編號(hào)是因?yàn)橛谜Z言描述計(jì)算機(jī)錯(cuò)誤常常令人費(fèi)解。用這種方式告訴您錯(cuò)誤的所在是一個(gè)最好的辦法。
在這種情形下，程序員的排錯(cuò)工作會(huì)十分高效。他們不知道發(fā)生了什么，也不可能到現(xiàn)場(chǎng)去觀察，所以他們一直在搜尋有價(jià)值的線索。錯(cuò)誤消息、錯(cuò)誤消息號(hào)以及一些莫名其妙的延遲，都是很重要的線索，就像辦案時(shí)的指紋一樣重要，保存好。
如果您使用UNIX系統(tǒng)，程序可能會(huì)產(chǎn)生一個(gè)內(nèi)核輸出（core dump）。內(nèi)核輸出是特別有用的線索來源，別扔了它們。另一方面，大多數(shù)程序員不喜歡收到含有大量?jī)?nèi)核輸出文件的EMAIL，所以在發(fā)郵件之前最好先問一下。還有一點(diǎn)要注意：內(nèi)核輸出文件記錄了完整的程序狀態(tài)，也就是說任何秘密（可能當(dāng)時(shí)程序正在處理一些私人信息或秘密數(shù)據(jù)）都可能包含在內(nèi)核輸出文件里。
“出了問題之后，我做了……”
當(dāng)一個(gè)錯(cuò)誤或bug發(fā)生的時(shí)候，您可能會(huì)做許多事情。但是大多數(shù)人會(huì)使事情變的更糟。我的一個(gè)朋友在學(xué)校里誤刪了她所有的Word文件，在找人幫忙之前她重裝了Word，又運(yùn)行了一遍碎片整理程序，這些操作對(duì)于恢復(fù)文件是毫無益處的，因?yàn)檫@些操作搞亂了磁盤的文件區(qū)塊。恐怕在這個(gè)世界上沒有一種反刪除軟件能恢復(fù)她的文件了。如果她不做任何操作，或許還有一線希望。
這種人仿佛一只被逼到墻角的鼬（黃鼠狼、紫貂一類的動(dòng)物——譯者注）：背靠墻壁，面對(duì)死亡的降臨奮起反撲，瘋狂攻擊。他們認(rèn)為做點(diǎn)什么總比什么都不做強(qiáng)。然而這些在處理計(jì)算機(jī)軟件問題時(shí)并不適用。不要做鼬，做一只羚羊。當(dāng)一只羚羊面對(duì)料想不到的情況或受到驚嚇時(shí)，它會(huì)一動(dòng)不動(dòng)，是為了不吸引任何注意，與此同時(shí)也在思考解決問題的最好辦法（如果羚羊有一條技術(shù)支持熱線，此時(shí)占線。）。然后，一旦它找到了最安全的行動(dòng)方案，它便去做。
當(dāng)程序出毛病的時(shí)候，立刻停止正在做的任何操作。不要按任何按鈕。仔細(xì)地看一下屏幕，注意那些不正常的地方，記住它或者寫下來。然后慎重地點(diǎn)擊 “確定” 或“取消”，選擇一個(gè)最安全的。 學(xué)著養(yǎng)成一種條件反射——一旦電腦出了問題，先不要?jiǎng)印Ｒ霐[脫這個(gè)問題，關(guān)掉受影響的程序或者重新啟動(dòng)計(jì)算機(jī)都不好，一個(gè)解決問題的好辦法是讓問題再次產(chǎn)生。程序員們喜歡可以被重現(xiàn)的問題，快樂的程序員可以更快而且更有效率的修復(fù)bug。
“我想粒子的躍遷與錯(cuò)誤的極化有關(guān)”
并不只是非專業(yè)的用戶才會(huì)寫出拙劣的bug報(bào)告，我見過一些非常差的bug報(bào)告出自程序員之手，有些還是非常優(yōu)秀的程序員。
有一次我與另一個(gè)程序員一起工作，他一直在找代碼中的bug，他常常遇到一個(gè)bug，但是不會(huì)解決，于是就叫我?guī)兔Α！俺鍪裁疵×耍俊蔽覇枴６幕卮饏s總是一些關(guān)于bug的意見。如果他的觀點(diǎn)正確，那的確是一件好事。這意味著他已經(jīng)完成了工作的一半，并且我們可以一起完成另一半工作。這是有效率并有用的。
但事實(shí)上他常常是錯(cuò)的。這就會(huì)使我們花上半個(gè)小時(shí)在原本正確的代碼里來回尋找錯(cuò)誤，而實(shí)際上問題出在別的地方。我敢肯定他不會(huì)對(duì)醫(yī)生這么做。“大夫，我得了Hydroyoyodyne（真是怪病——譯者），給我開個(gè)方子”，人們知道不該對(duì)一位醫(yī)生說這些。您描述一下癥狀，哪個(gè)地方不舒服，哪里疼、起皮疹、發(fā)燒……讓醫(yī)生診斷您得了什么病，應(yīng)該怎樣治療。否則醫(yī)生會(huì)把您當(dāng)做疑心病或精神病患者打發(fā)了，這似乎沒什么不對(duì)。
做程序員也是一樣。即便您自己的“診斷”有時(shí)真的有幫助，也要只說“癥狀”。“診斷”是可說可不說的，但是“癥狀”一定要說。同樣，在bug報(bào)告里面附上一份針對(duì)bug而做出修改的源代碼是有用處的，但它并不能替代bug報(bào)告本身。
如果程序員向您詢問額外的信息，千萬別應(yīng)付。曾經(jīng)有一個(gè)人向我報(bào)告bug，我讓他試一個(gè)命令，我知道這個(gè)命令不好用，但我是要看看程序會(huì)返回一個(gè)什么錯(cuò)誤（這是很重要的線索）。但是這位老兄根本就沒試，他在回復(fù)中說“那肯定不好用”，于是我又花了好些時(shí)間才說服他試了一下那個(gè)命令。
多動(dòng)動(dòng)腦筋對(duì)程序員是有幫助的。即使您的推斷是錯(cuò)誤的，程序員也應(yīng)該感謝您，您的嘗試使他們的工作變的更簡(jiǎn)單。不過千萬別忘了報(bào)告“癥狀”，否則只會(huì)使事情變得更糟。
“真是奇怪，剛才還不好用，怎么現(xiàn)在又好了？”
“間歇性錯(cuò)誤”著實(shí)讓程序員發(fā)愁。相比之下，進(jìn)行一系列簡(jiǎn)單的操作便能導(dǎo)致錯(cuò)誤發(fā)生的問題是簡(jiǎn)單的。程序員可以在一個(gè)便于觀察的條件下重復(fù)那些操作，觀察每一個(gè)細(xì)節(jié)。太多的問題在這種情況下不能解決，例如：程序每星期出一次錯(cuò)，或者偶然出一次錯(cuò)，或者在程序員面前從不出錯(cuò)（程序員一離開就出錯(cuò)。——譯者）。當(dāng)然還有就是程序的截止日期到了，那肯定要出錯(cuò)。
大多數(shù)“間歇性錯(cuò)誤”并不是真正的“間歇”。其中的大多數(shù)錯(cuò)誤與某些地方是有聯(lián)系的。有一些錯(cuò)誤可能是內(nèi)存泄漏產(chǎn)生的，有一些可能是別的程序在不恰當(dāng)?shù)臅r(shí)候修改某個(gè)重要文件造成的，還有一些可能發(fā)生在每一個(gè)小時(shí)的前半個(gè)小時(shí)中（我確實(shí)遇到過這種事情）。
同樣，如果您能使bug重現(xiàn)，而程序員不能，那很有可能是他們的計(jì)算機(jī)和您的計(jì)算機(jī)在某些地方是不同的，這種不同引起了問題。我曾寫過一個(gè)程序，它的窗口可以蜷縮成一個(gè)小球停在屏幕的左上角，它在別的計(jì)算機(jī)上只能在 800x600 解析度工作，但是在我的機(jī)器上卻可以在 1024x768 工作。
程序員想要了解任何與您發(fā)現(xiàn)的問題相關(guān)的事情。有可能的話您到另一臺(tái)機(jī)器上試試，多試幾次，兩次，三次，看看問題是不是經(jīng)常發(fā)生。如果問題出現(xiàn)在您進(jìn)行了一系列操作之后，不是您想讓它出現(xiàn)它就會(huì)出現(xiàn)，這就有可能是長時(shí)間的運(yùn)行或處理大文件所導(dǎo)致的錯(cuò)誤。程序崩潰的時(shí)候，您要盡可能的記住您都做了些什么，并且如果您看到任何圖形, 也別忘了提一下。 您提供的任何事情都是有幫助的。即使只是概括性的描述（例如：當(dāng)后臺(tái)有EMACS運(yùn)行時(shí)，程序常常出錯(cuò)），這雖然不能提供導(dǎo)致問題的直接線索，但是可能幫助程序員重現(xiàn)問題。
最重要的是：程序員想要確定他們正在處理的是一個(gè)真正的“間歇性錯(cuò)誤”呢，還是一個(gè)在另一類特定的計(jì)算機(jī)上才出現(xiàn)的錯(cuò)誤。他們想知道有關(guān)您計(jì)算機(jī)的許多細(xì)節(jié)，以便了解您的機(jī)器與他們的有什么不同。有許多細(xì)節(jié)都依仗特定的程序，但是有一件東西您一定要提供——版本號(hào)。程序的版本、操作系統(tǒng)的版本以及與問題有關(guān)的程序的版本。
“我把磁盤裝進(jìn)了我的Windows……”
表意清楚在一份bug報(bào)告里是最基本的要求。如果程序員不知道您說的是什么意思，那您就跟沒說一樣。我收到的bug報(bào)告來自世界各地，有許多是來自非英語國家，他們通常為自己的英文不好而表示歉意。總的來說，這些用戶發(fā)來的bug報(bào)告通常是清晰而且有用的。幾乎所有不清晰的bug報(bào)告都是來自母語是英語的人，他們總是以為只要自己隨便說說，程序員就能明白。
精確。
如果做相同的事情有兩種方法，請(qǐng)說明您用的是哪一種。例如：“我選擇了‘載入’”，可能意味著“我用鼠標(biāo)點(diǎn)擊‘載入’”或“我按下了‘ALT+L’”，說清楚您用了哪種方法，有時(shí)候這也有關(guān)系。
詳細(xì)。
信息寧多毋少！如果您說了很多，程序員可以略去一部分，可是如果您說的太少，他們就不得不回過頭再去問您一些問題。有一次我收到了一份bug報(bào)告只有一句話，每一次我問他更多事情時(shí)，他每次的回復(fù)都是一句話，于是我花了幾個(gè)星期的時(shí)間才得到了有用的信息。
謹(jǐn)慎使用代詞。
諸如“它”，“窗體”這些詞，當(dāng)它們指代不清晰的時(shí)候不要用。來看看這句話：“我運(yùn)行了FooApp，它彈出一個(gè)警告窗口，我試著關(guān)掉它，它就崩潰了。”這種表述并不清晰，用戶究竟關(guān)掉了哪個(gè)窗口？是警告窗口還是整個(gè)FooApp程序？您可以這樣說，“我運(yùn)行FooApp程序時(shí)彈出一個(gè)警告窗口，我試著關(guān)閉警告窗口，F(xiàn)ooApp崩潰了。”這樣雖然羅嗦點(diǎn)，但是很清晰不容易產(chǎn)生誤解。
檢查。
重新讀一遍您寫的bug報(bào)告，您覺得它是否清晰？如果您列出了一系列能導(dǎo)致程序出錯(cuò)的操作，那么照著做一遍，看看您是不是漏寫了一步。
小結(jié)：
bug報(bào)告的首要目的是讓程序員親眼看到錯(cuò)誤。如果您不能親自做給他們看，給他們能使程序出錯(cuò)的詳細(xì)的操作步驟。
如果首要目的不能達(dá)成，程序員不能看到程序出錯(cuò)。這就需要bug報(bào)告的第二個(gè)目的來描述程序的什么地方出毛病了。詳細(xì)的描述每一件事情：您看到了什么，您想看到什么，把錯(cuò)誤消息記下來，尤其是“錯(cuò)誤消息號(hào)”。
當(dāng)您的計(jì)算機(jī)做了什么您料想不到的事，不要?jiǎng)樱≡谀届o下來之前什么都別做。不要做您認(rèn)為不安全的事。
盡量試著自己“診斷”程序出錯(cuò)的原因（如果您認(rèn)為自己可以的話）。即使做出了“診斷”，您仍然應(yīng)該報(bào)告“癥狀”。
如果程序員需要，請(qǐng)準(zhǔn)備好額外的信息。如果他們不需要，就不會(huì)問您要。他們不會(huì)故意為難自己。您手頭上一定要有程序的版本號(hào)，它很可能是必需品。
表述清楚，確保您的意思不能被曲解。
總的來說，最重要的是要做到精確。程序員喜歡精確。
就是上面這兩本書，給了自己一些啟發(fā)：
提問之前需要做的事情！
1 通讀手冊(cè)，試著自己找答案。
2 在FAQ里找答案。
3 在網(wǎng)上搜索(個(gè)人推薦Google)
4 向你身邊精于此道的朋友打聽
RTFM ->Read the Fucking Manual
STFW -> Search the Fucking Web
下面總結(jié)這一周：
1 周六開始了我的轉(zhuǎn)博英語考試，如果不是中頭彩的話，應(yīng)該是掛掉了。。。呵呵，很淡然。。沒有特別準(zhǔn)備英語，感覺以后需要拿出一段時(shí)間來，好好看一下英語的相關(guān)東西。
2 圣誕節(jié)和大家一起去比格吃了個(gè)飯，然后去祥源玩三國殺，呵呵，還都蠻happy的。
不過，自己很差勁的是沒有照顧和Sarah，唉，或許在這方面真的挺遲鈍的吧。。而且非常的自以為是。。。
3 這個(gè)周的主要工作集中在了熟悉QT4 和OSG上，感覺OSG的編寫人員真是NB到High，是在非常強(qiáng)悍。代碼組織的非常好，恩，要好好熟悉一下這個(gè)三維場(chǎng)景渲染引擎。
4 然后剩下的事情就比較囧了。。算法作業(yè)要交了，這個(gè)周寫完所有作業(yè)。
然后琪琪的圖形學(xué)作業(yè)，爭(zhēng)取今天給她搞完吧。。然后是summer的圖形學(xué)，就用OSG給她搭一個(gè)吧。。呵呵。
5 然后是論文的事情。。總之自己要努力加油啦。。
6 養(yǎng)成一個(gè)好的作息習(xí)慣，來這里很多天了，沒有養(yǎng)成一個(gè)好的作息習(xí)慣，實(shí)在是不應(yīng)該啊。。。10:20或者10:40回。。11:30睡覺。。照成6:45 起床，然后各種事情。。中午1:45之前來到實(shí)驗(yàn)室。。。這樣子加起來也就是3:30+ 3:30+ 3:30 加油吧！