萬(wàn)千代碼，文檔奈何只是幾行淡墨

佛法有云，諸法無(wú)性，盡隨心轉(zhuǎn)。白話(huà)就是，啥事都不要定性，太早下結(jié)論容易被打臉。要知道，心情變了，看法也就不一樣了，比如婚前女友的叮囑你只當(dāng)可愛(ài)，到了婚后，老婆的叮嚀便成了聒噪。其實(shí)，咱也不好罵這男人薄情，相見(jiàn)時(shí)難別亦難，東風(fēng)無(wú)力百花殘。當(dāng)時(shí)過(guò)境遷，歲月摧殘了紅顏，就算咱情比金堅(jiān)，柔情款款也早變成了柴米油鹽。昨日難再回，往日不可追，既然地球無(wú)法停轉(zhuǎn)，咱們又何必刻舟求劍！

　　1

　　據(jù)說(shuō)，程序猿平生最煩兩件事，一則是別人要求他給自己編的代碼寫(xiě)文檔，二則是別人留下的代碼沒(méi)有留下文檔。

　　別人要求自己寫(xiě)文檔這事吧，碼農(nóng)們大可傲嬌地想：“我寫(xiě)的代碼閱讀性這么好，居然還要求老子寫(xiě)文檔，多此一舉，生命好寶貴，不可再浪費(fèi)的好不好！”，而對(duì)于別人的代碼沒(méi)留文檔這檔子事呢，碼農(nóng)們卻很是可以借此大發(fā)牢騷，“悲了個(gè)催的，寫(xiě)完代碼，趁著熱乎勁順手寫(xiě)點(diǎn)文檔又不耽誤多大功夫，利人利己嘛！關(guān)鍵是這天殺的代碼寫(xiě)得這么晦澀難懂，還好意思不留文檔，真是不負(fù)責(zé)任之極也，xx**&&***!” 。

　　都是大哥不說(shuō)二哥，但聰明“絕了頂”的碼農(nóng)們難道意識(shí)不到，這是赤裸裸的五十步笑百步，典型的搞雙重標(biāo)準(zhǔn)嗎？難道其智商突然被溢出的情緒堆棧清了零嗎？非也非也，在灑家看來(lái)，同行們一向智商出眾，在寫(xiě)文檔的事情上如此嚴(yán)于待人，寬于律己，實(shí)在是因?yàn)榇蠖鄶?shù)人都喜歡寫(xiě)代碼、討厭寫(xiě)文檔的緣故。何至于此，且聽(tīng)灑家娓娓道來(lái)。

　　2

　　還記得科比和凌晨四點(diǎn)的洛杉磯的故事嗎？

　　當(dāng)年，一位傻白甜記者壓抑著內(nèi)心激蕩不已的崇拜，問(wèn)起橫掃籃壇的科比：“你為什么能如此成功呢？”科比挺著被自信充脹起來(lái)的鼓囊囊的胸肌，反問(wèn)道：“你知道洛杉磯凌晨四點(diǎn)鐘是什么樣子嗎？”記者微微一笑，識(shí)趣地?fù)u搖頭：“不知道，什么樣兒？”科比撓撓頭，說(shuō)：“滿(mǎn)天星星，寥落的燈光，行人很少?！边豆景胩旌螅票染拖裨谀顝V告語(yǔ)一樣，字斟句酌地說(shuō)道，“十多年過(guò)去了，洛杉磯街道早上四點(diǎn)的黑暗仍然沒(méi)有改變，但我卻已變成了肌肉強(qiáng)健，有體能、有力量，有著很高投籃命中率的運(yùn)動(dòng)員?！比缓?，科比咧開(kāi)嘴笑了起來(lái)，白白的牙齒，黑黑的臉龐，讓他的笑臉顯得格外燦爛。

　　采訪(fǎng)結(jié)束后的這天夜里，記者頂著因?yàn)榻?jīng)常熬夜趕稿而發(fā)黑的眼圈，喝著提神的苦咖啡，再一次站在窗臺(tái)前，望著凌晨四點(diǎn)籠罩在一片黑暗之中的洛杉磯，苦苦思索著一個(gè)思考了很多遍但總是不得要領(lǐng)的問(wèn)題：“頭頂同一片天，腳踩同一方地，為什么科比穿梭在凌晨四點(diǎn)的洛杉磯，日復(fù)一日，十多年來(lái)樂(lè)此不彼，終于成就了當(dāng)下的自己，而我卻只想草草地寫(xiě)完稿子，早早地回家睡覺(jué)？”一念至此，他又想起了中國(guó)喜劇演員范偉在小品《賣(mài)拐》里的一句經(jīng)典臺(tái)詞：“同樣是人，差距怎么就那么大尼！”

　　夜，愈發(fā)地深沉了，洛杉磯的凌晨異常寂靜，好像罩著一層輕紗，被偶爾駛過(guò)的一輛汽車(chē)震顫一下，再度恢復(fù)平靜。微風(fēng)輕輕吹動(dòng)記者頭頂那日漸稀少的頭發(fā)，送來(lái)一句弱不可聞的答案：“堅(jiān)持早起，科比能年入數(shù)千萬(wàn)美金，而你卻只能掙點(diǎn)可憐的稿費(fèi)！！稿費(fèi)。。?！?/p>

　　明月如鉤，將冷冷的月光灑在記者憔悴的臉龐上，他落寞地佇立窗臺(tái)，像老牛反芻一樣仔細(xì)咂摸著這句答案，一時(shí)間，竟不能自已，任憑風(fēng)起如刀，吹落汩汩涌出到因多日繁忙未及修剪的胡須中的熱淚，滴入仍然冒著熱氣的廉價(jià)咖啡中。

　　相比之下，收入比記者更為悲催的程序員呢？睡得比妓晚，起得比雞早，只因娃娃要上各種輔導(dǎo)班，婆娘們要過(guò)美好生活，便只能強(qiáng)撐著加速老化的殘軀，拿著微薄的收入，帶著聽(tīng)診器寫(xiě)代碼，將心比心，我們又怎么忍心苛責(zé)碼農(nóng)們?yōu)槭裁床粚?xiě)文檔呢？行文至此，四大不空的灑家竟然悲傷得不能自已，唉，唉，竟不知說(shuō)啥好了。

　　在諸多碼農(nóng)眼中，寫(xiě)文檔，不寫(xiě)文檔，工資標(biāo)準(zhǔn)就在那里，不高也不低。

　　3

　　天下熙熙，皆為利來(lái)，天下往往，皆為利往。做為萬(wàn)物之靈的人類(lèi)一向是無(wú)利不起早，當(dāng)然會(huì)自覺(jué)地選擇利益最大化的工作方式。

　　碼農(nóng)的工作就是寫(xiě)代碼，讓系統(tǒng)正常穩(wěn)定地跑起來(lái)，既然寫(xiě)文檔貌似不能多掙錢(qián)，誰(shuí)不希望過(guò)著晃晃悠悠、又是一周的日子呢？干嘛自我加壓，背上個(gè)寫(xiě)文檔的苦差事？

　　但是如果，寫(xiě)文檔不僅有好處，而且好處大大滴呢？

　　通過(guò)寫(xiě)文檔表達(dá)設(shè)計(jì)思想、總結(jié)工作中的經(jīng)驗(yàn)教訓(xùn)之類(lèi)的老生常談，灑家自然不屑再言，也無(wú)需多言。灑家想在這里分享給大家的，是在多年邊寫(xiě)代碼邊寫(xiě)文檔的職業(yè)生涯中體會(huì)到的貨真價(jià)實(shí)的好處，細(xì)細(xì)說(shuō)來(lái)，大致有三。

　　4

　　一則幫助快速修改代碼。

　　都說(shuō)好事多磨，好代碼也如是，需要反復(fù)多次打磨。據(jù)說(shuō)在佛門(mén)中證了初果、得了道共戒的修行者“初果耕地，蟲(chóng)離四寸”，耕地時(shí)，自然而然地不會(huì)碰到田地中的蟲(chóng)子，也就不會(huì)犯殺戒。天才碼農(nóng)改代碼時(shí)也差不多是這種境界，改起來(lái)行云流水，指哪打哪，自然而然地不會(huì)因?yàn)楦牧艘惶幋a而影響了其它的地方。

　　但是，程序員群體中更多的是像灑家這樣的平庸之輩，改代碼時(shí)掛一漏萬(wàn)，互相牽連。經(jīng)常是拆了東墻，倒了西墻，改了代碼后，信心百倍地認(rèn)為不會(huì)帶來(lái)其它影響，但多次被無(wú)情的事實(shí)打臉。倘若有平時(shí)寫(xiě)代碼時(shí)留下的文檔，清楚地寫(xiě)明了模塊之間的關(guān)聯(lián)，這樣的錯(cuò)誤就會(huì)減少很多，工作更輕松不說(shuō)，也保全了臉面不是？