導(dǎo)讀:
作為程序員,有沒有讓你感到既無語又崩潰的代碼注釋饭望?
StackOverflow 上有一個類似的問題,問大家見過哪些超秀的注釋坦胶,不少程序員紛紛吐槽自己見過的那些逆天注釋惊窖,我們一起來圍觀一下。
1. 只有上帝知道
//我寫這一行的時候哀蘑,只有上帝和我知道我在寫什么
//現(xiàn)在诚卸,只有上帝知道了
2. 相隔時空的diss
//somedev1 - 6/7/02 添加對登錄屏幕的暫時追蹤功能
//somedev2 - 5/22/07 暫時個屁
(仿佛看到兩個程序員相隔時空的diss)
3. 喝大了
//喝大了葵第,等會再修bug
4. 有魔法,別碰
//有魔法合溺,別碰卒密。
5. 開森嗎?
//開森地調(diào)bug吧棠赛,傻x
(隔著屏幕都想打他一頓)
6. 糊弄過去算了
/*
*你可能覺得自己看懂下面的代碼了哮奇,
*然而你并沒有,相信我睛约。
*糊弄過去算了鼎俘,不然你會好多個晚上睡不著覺,
*嘴里罵著這段注釋辩涝,覺得自己很聰明贸伐,
*真能“優(yōu)化”下面的代碼。
*現(xiàn)在關(guān)上文件怔揩,去玩點別的吧捉邢。
*/
7. 你懂的
//這代碼真是爛透了,你懂的商膊,我也懂的歌逢。
8. 先往下看
//先往下看,后面再喊我傻X翘狱。
9. 好怕怕
//我也不確定我們到底需不需要這個秘案,但是刪了又特害怕。
10. 到底要怎樣潦匈?
#要想理解遞歸阱高,移步本文件底部
然后翻到文件底部:
#要想理解遞歸,移步本文件頂部
11. 本人對本代碼概不負責(zé)
//本人對本代碼概不負責(zé)茬缩,
//他們讓我寫的赤惊,非本人自愿。
12. 我偏不
//就不給你們寫注釋
//這代碼寫得這么費勁
//所以你們讀著也得費勁
13. 沒有錯凰锡,不好用就不是我寫的
//如果這段代碼跑的通未舟,那就是Paul DiLascia寫的。要是跑不通掂为,
//那我就不知道是誰寫的了
14. 沒毛病
//這公式?jīng)]毛病裕膀,你要不信自己去算
15. 就問你服不服
//要是你想被炒魷魚,那就刪吧
16. 好好活著
//如果將來讀到這行代碼勇哗,我會穿越回來昼扛,然后一死以謝天下。
17. 謹以此代碼獻給我的老婆
//謹以此代碼和我所有的工作獻給我的老婆Darlene欲诺,
//這段代碼要是放出去抄谐,
//她就得照顧我還有三個孩子了渺鹦。
(潛臺詞是自己代碼寫的太爛,會丟了工作或者造成公司倒閉)
18. 我讀書少蛹含,別騙我
//別刪這行注釋啊毅厚,刪了程序就崩了
19. 仇恨綿綿不絕
放個大招,在 GitHub 上有這么一個腳本浦箱,前面好好的吸耿,很正常,到了中間作者忽然用注釋對 Adobe PSD 來了一大段的瘋狂吐槽:
//到了這個份兒上憎茂,我得給你說說這個 Adobe PSD 格式。
//PSD 可不是個好格式锤岸,它甚至都是不個壞格式竖幔,叫它壞格式都是
//對 PCX 和 JPEG 這些壞格式的一種侮辱。不是偷,PSD 是一種爛到家的格式拳氢。
//我忙活這段代碼好幾個星期了,我對 PSD 日漸增長的仇恨蛋铆,
//如同數(shù)百萬個太陽燃燒成的怒火馋评,綿綿不絕。
//如果有兩種不同的做事方法刺啦,PSD 會兩個都試一遍留特。
//然后再以正常人無法想象的方式想出三個甚至三個以上的方法,
//把它們也都試一遍玛瘸。PSD 把“前后矛盾”上升成了一門藝術(shù)蜕青。比方說,
//為啥它忽然就決定這些特定組塊對齊 4 比特糊渊,而且這種對齊方式
//不應(yīng)該包含在尺寸內(nèi)右核?其它地方的組塊要么沒對齊,
//要么對齊方式包含在尺寸內(nèi)渺绒。這里就沒包含在內(nèi)贺喝。
//這三種方式任何一種都是可以的,智商正常的格式都會只用一種宗兼,
//我們的 PSD 當(dāng)然是三種都用了躏鱼,而且不止三種。
//從 PSD 文件里拿到數(shù)據(jù)殷绍,就跟從你那 58 歲生日時被一條抓狂的淡水鯊魚干掉的
//上歲數(shù)的怪叔叔家的閣樓上想找出點好東西一樣挠他。
//用鯊魚這個比方不是我要表達的重點啊,但是我現(xiàn)在正在苦思冥想篡帕,
//那些小題大做搞出這種文件格式的人該有怎樣搞笑的人生啊殖侵。
//之前吧贸呢,我想找到這種文件格式的最新說明書。
//為此拢军,我必須向他們申請許可楞陷,他們才考慮送我
//這本神圣的“秘籍”。整個過程還得向他們傳真
//一些文件的復(fù)印件茉唉,或者可能還得簽點秘密協(xié)議固蛾。
//我只能覺得,他們把這個流程搞這么復(fù)雜就是因為
//他們造出了這么惡心的東西度陆,心里有愧艾凯。我是自然不會
//按他們的意思走這個流程的。但是假如我真的
//這么做的話懂傀,我會把說明書的每一頁都打印出來趾诗,
//一把火給它燒了。要是能有超能力蹬蚁,
//我會把說明書的所有復(fù)印件都收集過來恃泪,
//放到宇宙飛船上,直接發(fā)配到太陽犀斋。
//
//PSD 不是我喜歡的文件格式贝乎。
看來是實在忍無可忍了。吐槽完這一段后叽粹,作者又繼續(xù)淡定地寫完了腳本览效。
這段腳本的地址:
https://github.com/zepouet/Xee-xCode-4.5/blob/master/XeePhotoshopLoader.m#L108
20. 新人默默的在后面增加一行注釋:浪費在這里的總時間=48h
21. 新人看到這樣的注釋都不用再嘗試了,感恩前輩
22. 即使系統(tǒng)終止運行虫几,這個BUG依然存在
23. 只能說下家公司真慘朽肥,這是有多大的積怨呢
24. 整個網(wǎng)站就此垮掉......
25. 敢這么詛咒老板的,我敬你是條漢子
26. 你不可能看懂這個
這是一段來自貝爾實驗室的持钉,第六版Unix Kernel衡招,注釋語句為“you are not expected to understand this”,意思就是每强,你不可能看懂這個始腾。
27. 窮逼VIP
去年蝦米音樂客戶端的程序員竟然稱一些活動送的VIP客戶為“窮逼VIP“,引發(fā)了網(wǎng)友爭議空执。
28. 不解釋浪箭,看注釋
29. 聽前輩的話,把這塊程序去掉就好了
30. 調(diào)試了半天才看到這個辨绊,新人表示已淚奔
31. 你有freestyle嗎奶栖,也來一個?
32. 顧客要是不會看個代碼注釋,被坑了可能還不知道
33. 雖然沒有年終獎宣鄙,但我們有很多bug呀袍镀!
剛?cè)肼毜某绦騿T估計會被嚇跑,然后感謝一下前輩冻晤。
34. 就連Nike也嘗試了在他們的robots文件里加入了一個有趣的圖案
35. 超級有自知之明的代碼注釋
36. 致敬每一個勇敢的編程騎士
37. 當(dāng)然苇羡,閑的蛋疼的猿,還會做這樣的注釋
或者這樣的:
甚至這樣的:
38. 據(jù)說下圖是程序員寫注釋時的基本思路
39. 最后鼻弧,送給廣大開發(fā)者們设江,恭祝代碼無Bug