導(dǎo)讀：作為程序員，有沒(méi)有讓你感到既無(wú)語(yǔ)又崩潰的代碼注釋？StackOverflow 上有一個(gè)類似的問(wèn)題，問(wèn)大家見(jiàn)過(guò)哪些超秀的注釋，不少程序員紛紛吐槽自己見(jiàn)過(guò)的那些逆天注釋，我們一起來(lái)圍觀一下。

1. 只有上帝知道

//我寫這一行的時(shí)候，只有上帝和我知道我在寫什么

//現(xiàn)在，只有上帝知道了

2. 相隔時(shí)空的diss

//somedev1 -  6/7/02 添加對(duì)登錄屏幕的暫時(shí)追蹤功能

//somedev2 -  5/22/07 暫時(shí)個(gè)屁

（仿佛看到兩個(gè)程序員相隔時(shí)空的diss）

3. 喝大了

//喝大了，等會(huì)再修bug

4. 有魔法，別碰

//有魔法，別碰。

5. 開(kāi)森嗎？

//開(kāi)森地調(diào)bug吧，傻x

（隔著屏幕都想打他一頓）

6. 糊弄過(guò)去算了

/*

*你可能覺(jué)得自己看懂下面的代碼了，

*然而你并沒(méi)有，相信我。

*糊弄過(guò)去算了，不然你會(huì)好多個(gè)晚上睡不著覺(jué)，

*嘴里罵著這段注釋，覺(jué)得自己很聰明，

*真能“優(yōu)化”下面的代碼。

*現(xiàn)在關(guān)上文件，去玩點(diǎn)別的吧。

*/

7. 你懂的

//這代碼真是爛透了，你懂的，我也懂的。

8. 先往下看

//先往下看，后面再喊我傻X。

9. 好怕怕

//我也不確定我們到底需不需要這個(gè)，但是刪了又特害怕。

10. 到底要怎樣？

#要想理解遞歸，移步本文件底部

然后翻到文件底部：

#要想理解遞歸，移步本文件頂部

11. 本人對(duì)本代碼概不負(fù)責(zé)

//本人對(duì)本代碼概不負(fù)責(zé)，

//他們讓我寫的，非本人自愿。

12. 我偏不

//就不給你們寫注釋

//這代碼寫得這么費(fèi)勁

//所以你們讀著也得費(fèi)勁

13. 沒(méi)有錯(cuò)，不好用就不是我寫的

//如果這段代碼跑的通，那就是Paul DiLascia寫的。要是跑不通，

//那我就不知道是誰(shuí)寫的了

14. 沒(méi)毛病

//這公式?jīng)]毛病，你要不信自己去算

15. 就問(wèn)你服不服

//要是你想被炒魷魚(yú)，那就刪吧

16. 好好活著

//如果將來(lái)讀到這行代碼，我會(huì)穿越回來(lái)，然后一死以謝天下。

17. 謹(jǐn)以此代碼獻(xiàn)給我的老婆

//謹(jǐn)以此代碼和我所有的工作獻(xiàn)給我的老婆Darlene，

//這段代碼要是放出去，

//她就得照顧我還有三個(gè)孩子了。

（潛臺(tái)詞是自己代碼寫的太爛，會(huì)丟了工作或者造成公司倒閉）

18. 我讀書(shū)少，別騙我

//別刪這行注釋啊，刪了程序就崩了

19. 仇恨綿綿不絕

放個(gè)大招，在 GitHub 上有這么一個(gè)腳本，前面好好的，很正常，到了中間作者忽然用注釋對(duì) Adobe PSD 來(lái)了一大段的瘋狂吐槽：

//到了這個(gè)份兒上，我得給你說(shuō)說(shuō)這個(gè) Adobe PSD 格式。

//PSD 可不是個(gè)好格式，它甚至都是不個(gè)壞格式，叫它壞格式都是

//對(duì) PCX 和 JPEG 這些壞格式的一種侮辱。不，PSD 是一種爛到家的格式。

//我忙活這段代碼好幾個(gè)星期了，我對(duì) PSD 日漸增長(zhǎng)的仇恨，

//如同數(shù)百萬(wàn)個(gè)太陽(yáng)燃燒成的怒火，綿綿不絕。

//如果有兩種不同的做事方法，PSD 會(huì)兩個(gè)都試一遍。

//然后再以正常人無(wú)法想象的方式想出三個(gè)甚至三個(gè)以上的方法，

//把它們也都試一遍。PSD 把“前后矛盾”上升成了一門藝術(shù)。比方說(shuō)，

//為啥它忽然就決定這些特定組塊對(duì)齊 4 比特，而且這種對(duì)齊方式

//不應(yīng)該包含在尺寸內(nèi)？其它地方的組塊要么沒(méi)對(duì)齊，

//要么對(duì)齊方式包含在尺寸內(nèi)。這里就沒(méi)包含在內(nèi)。

//這三種方式任何一種都是可以的，智商正常的格式都會(huì)只用一種，

//我們的 PSD 當(dāng)然是三種都用了，而且不止三種。

//從 PSD 文件里拿到數(shù)據(jù)，就跟從你那 58 歲生日時(shí)被一條抓狂的淡水鯊魚(yú)干掉的

//上歲數(shù)的怪叔叔家的閣樓上想找出點(diǎn)好東西一樣。

//用鯊魚(yú)這個(gè)比方不是我要表達(dá)的重點(diǎn)啊，但是我現(xiàn)在正在苦思冥想，

//那些小題大做搞出這種文件格式的人該有怎樣搞笑的人生啊。

//之前吧，我想找到這種文件格式的最新說(shuō)明書(shū)。

//為此，我必須向他們申請(qǐng)?jiān)S可，他們才考慮送我

//這本神圣的“秘籍”。整個(gè)過(guò)程還得向他們傳真

//一些文件的復(fù)印件，或者可能還得簽點(diǎn)秘密協(xié)議。

//我只能覺(jué)得，他們把這個(gè)流程搞這么復(fù)雜就是因?yàn)?/span>

//他們?cè)斐隽诉@么惡心的東西，心里有愧。我是自然不會(huì)

//按他們的意思走這個(gè)流程的。但是假如我真的

//這么做的話，我會(huì)把說(shuō)明書(shū)的每一頁(yè)都打印出來(lái)，

//一把火給它燒了。要是能有超能力，

//我會(huì)把說(shuō)明書(shū)的所有復(fù)印件都收集過(guò)來(lái)，

//放到宇宙飛船上，直接發(fā)配到太陽(yáng)。

//

//PSD 不是我喜歡的文件格式。

看來(lái)是實(shí)在忍無(wú)可忍了。吐槽完這一段后，作者又繼續(xù)淡定地寫完了腳本。

這段腳本的地址：

https://github.com/zepouet/Xee-xCode-4.5/blob/master/XeePhotoshopLoader.m#L108

20. 新人默默的在后面增加一行注釋：浪費(fèi)在這里的總時(shí)間=48h

21. 新人看到這樣的注釋都不用再嘗試了，感恩前輩

22. 即使系統(tǒng)終止運(yùn)行，這個(gè)BUG依然存在

23. 只能說(shuō)下家公司真慘，這是有多大的積怨呢

24. 整個(gè)網(wǎng)站就此垮掉......

25. 敢這么詛咒老板的，我敬你是條漢子

26. 你不可能看懂這個(gè)

這是一段來(lái)自貝爾實(shí)驗(yàn)室的，第六版Unix Kernel，注釋語(yǔ)句為“you are not expected to understand this”，意思就是，你不可能看懂這個(gè)。

27. 窮逼VIP

去年蝦米音樂(lè)客戶端的程序員竟然稱一些活動(dòng)送的VIP客戶為“窮逼VIP“，引發(fā)了網(wǎng)友爭(zhēng)議。

28. 不解釋，看注釋

29. 聽(tīng)前輩的話，把這塊程序去掉就好了

30. 調(diào)試了半天才看到這個(gè)，新人表示已淚奔

31. 你有freestyle嗎，也來(lái)一個(gè)？

32. 顧客要是不會(huì)看個(gè)代碼注釋，被坑了可能還不知道

33. 雖然沒(méi)有年終獎(jiǎng)，但我們有很多bug呀！

剛?cè)肼毜某绦騿T估計(jì)會(huì)被嚇跑，然后感謝一下前輩。

34. 就連Nike也嘗試了在他們的robots文件里加入了一個(gè)有趣的圖案

35. 超級(jí)有自知之明的代碼注釋

36. 致敬每一個(gè)勇敢的編程騎士

37. 當(dāng)然，閑的蛋疼的猿，還會(huì)做這樣的注釋

或者這樣的：

甚至這樣的：

38. 據(jù)說(shuō)下圖是程序員寫注釋時(shí)的基本思路

39. 最后，送給廣大開(kāi)發(fā)者們，恭祝代碼無(wú)Bug

- END- 

 文章來(lái)源：薛定諤的coding貓整理