請注釋你那該死的代碼！
我站出來就是為了要說一句：
| 請注釋你那該死的代碼。 |
每次我遇到一個程序員——有時是相當高水的——總發(fā)現(xiàn)他會認為：你并不需要給你的代碼加注釋。我要說，這就是胡說八道。我很長時間以來一直這么表達。問題是，讓事情改變要比你想象的難。雖然我們正處在努力編寫那些討厭的代碼、準備發(fā)布一些會令人驚嘆的新東西的緊要關(guān)頭，我們?nèi)匀粠缀踝⑨屗械臇|西。沒有任何借口不去做這些事情。每隔3到7行代碼，你就能看到有長篇的社論發(fā)表。有時，幾百行代碼里，你就能找到一個很好的笑話。
錯誤的藏身之處
看，一個是你想要的，一個是你實現(xiàn)的。你的bug就在這兩者之間。如果寫了注釋，你就是在告訴我你想要的。而你的代碼中告訴我你是如何去做的。程序的缺陷要么存在于你想要的想法中，要么，需求是對的，而你的代碼有問題。請幫助我，讓我知道究竟是哪個錯了。
不要偷懶
一個常見的反對聲音是：我聽說，注釋經(jīng)常會過期，因為代碼會經(jīng)常更新，而注釋不會。你不更新注釋嗎？你的同事也不？不要偷懶，不要養(yǎng)成一個讓人認為偷點兒懶無所謂的文化氛圍。告訴同事你是如何一絲不茍的注釋程序的，讓他們知道你也希望他們這樣去做。說不注釋是因為怕某人或某些地方在將來會造成你的錯誤，這只是在找借口。
你是有經(jīng)驗的人
人本無知，這很自然，但你是有經(jīng)驗的人。因此，你有義務教育那些需要學習的人。你的注釋會指導那些正在閱讀你的代碼的人。告訴他們?yōu)槭裁丛谶@里要用Tuple數(shù)據(jù)結(jié)構(gòu)，而不是用其它的(更好的做法是附加一個stack overflow或dotnetperls上的鏈接 … 你完全可以做到這些，不是嗎？)你在這走了一個什么捷徑？如果不走捷徑你就不能按時發(fā)布，所以，告訴這些新手你遇到的特殊情況。否則的話，最終你的不好的代碼將會被四處拷貝，四處散播。看！你寫的爛代碼變成了公司的程序模板！完全沒有注釋！
你會打字
我的招聘過程有一部分是白板編程，一部分是鍵盤編程。所有好的程序員都是打字高手。就說你每分鐘能打出40-60詞。那請你告訴我，為什么在你機槍掃射似的編寫代碼時不加上注釋呢？當然，你可以花30秒時間告訴我，代碼寫的這樣一團糟是因為搞業(yè)務的那個家伙需要程序在本周發(fā)布而換回不菲的7.5萬美元?？墒窍聜€月呢？這些代碼不要了？封存到石頭里了？我知道這些代碼是在干什么。但請告訴我你的意圖。
你在一天天變老
聽我說，我編程已經(jīng)很久了，也許早在你上中學之前。我仍然在編程，我仍然喜歡編程。有朝一日，你也會變的跟我一樣老。如果你到了像我一樣(那時我已經(jīng)沒有能力再教育你)，那時，有太多的層，有太多的抽象，有太多的技術(shù)架構(gòu)，你無法完全記住。你的注釋就能出來指導你。它們會告訴你，6個月前，你是用這種方法、這種模式實現(xiàn)的，而且這樣做只是為了炫耀。如果你是一個真正優(yōu)秀——并且仍然在做編程的程序員——你會認識到，這些代碼寫的很爛，你現(xiàn)在需要以不同的方式重新實現(xiàn)它。而你仍然有你的注釋來讓你回憶起當時的想法和為什么這樣做。
所以，請注釋你那該死的代碼。
