萬(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),咱們又何必刻舟求劍!
本文引用地址:http://cafeforensic.com/article/201811/394464.htm1
據(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)天星星,寥落的燈光,行人很少?!边豆景胩旌?,科比就像在念廣告語(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ō),也保全了臉面不是?
評(píng)論