萬千代碼，文檔奈何只是幾行淡墨

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

　　1

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

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

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

　　2

　　還記得科比和凌晨四點的洛杉磯的故事嗎？

　　當年，一位傻白甜記者壓抑著內(nèi)心激蕩不已的崇拜，問起橫掃籃壇的科比：“你為什么能如此成功呢？”科比挺著被自信充脹起來的鼓囊囊的胸肌，反問道：“你知道洛杉磯凌晨四點鐘是什么樣子嗎？”記者微微一笑，識趣地搖搖頭：“不知道，什么樣兒？”科比撓撓頭，說：“滿天星星，寥落的燈光，行人很少。”叨咕半天后，科比就像在念廣告語一樣，字斟句酌地說道，“十多年過去了，洛杉磯街道早上四點的黑暗仍然沒有改變，但我卻已變成了肌肉強健，有體能、有力量，有著很高投籃命中率的運動員。”然后，科比咧開嘴笑了起來，白白的牙齒，黑黑的臉龐，讓他的笑臉顯得格外燦爛。

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

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

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

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

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

　　3

　　天下熙熙，皆為利來，天下往往，皆為利往。做為萬物之靈的人類一向是無利不起早，當然會自覺地選擇利益最大化的工作方式。

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

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

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

　　4

　　一則幫助快速修改代碼。

　　都說好事多磨，好代碼也如是，需要反復多次打磨。據(jù)說在佛門中證了初果、得了道共戒的修行者“初果耕地，蟲離四寸”，耕地時，自然而然地不會碰到田地中的蟲子，也就不會犯殺戒。天才碼農(nóng)改代碼時也差不多是這種境界，改起來行云流水，指哪打哪，自然而然地不會因為改了一處代碼而影響了其它的地方。

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