程序員必知必會之blog篇 網(wǎng)易廣州?????? 賴勇浩（http://blog.csdn.net/lanphaday） 本文最初發(fā)表于戀花蝶的博客（http://blog.csdn.net/lanphaday），歡迎轉(zhuǎn)載，但請務(wù)必保留全文完整，不得用于商業(yè)目的。 緣起 雖然我寫博客到現(xiàn)在只有兩年多時間，但因為文章多是原創(chuàng)，還經(jīng)常被推薦到CSDN首頁，又在幾個雜志上灌過水，所以也有不少朋友問過我相同的話題：我在學(xué)習(xí)／工作中有很多感悟，但我寫不出來啊，有什么好方法嗎？問這個問題的有師弟師妹，也有朋友同事，甚至有一些是有近十年經(jīng)驗的資深技術(shù)人員。 后來看到CSDN blog開通了近20萬個專欄，卻只有不到55萬篇原創(chuàng)文章，平均一個專欄還不到三篇文章。這說明有很多程序員，想寫卻寫不出來，寫了卻沒能堅持下來。這終究是一個方法問題。 向我咨詢的一位有十年經(jīng)驗的資深技術(shù)人員，他給我看了一些他的作品。我驚嘆于其中的技術(shù)，極力鼓吹他把其中的技術(shù)體會寫出來，但他的回答是：我也想寫出來給大家參考，但我下筆寫不了三句話啊！ 眼看著一個個技術(shù)專家有心無力，無可奈何地看自己的技術(shù)流失；眼看著一個個年輕后進無法分享學(xué)習(xí)路上遇到的困難和解決方案；眼看著大家上窮碧落下黃泉，用盡谷歌加百度也無法找到有效的參考方案。我感到自己有責(zé)任站出來，分享自己寫文章的心得和套路，讓更多人能夠?qū)懖┛汀酚趯懖┛?#xff1b;把自己的所得分享給大眾，回報行業(yè)，回報社會。 看圖作文 無論現(xiàn)在你的成就多大，你也不得不承認在小學(xué)（甚至是幼兒園）學(xué)到的東西讓你終生受用無窮。看圖作文就是這樣一門有用的學(xué)問。 （本圖純屬非商業(yè)用途引用，版權(quán)歸原作者所有！） 看著上面搞笑的漫畫，無論是誰都能寫上一兩百字吧？ 其實，看圖作文法是寫博客的好幫手哦！君不見多少網(wǎng)站編輯就靠這招就能混得人模狗樣有房有車么？千萬不要小看啊！我們寫技術(shù)文章的時候，可以套用這樣一個套路來寫文章： 1、?先畫幾幅圖，如軟件需求圖、架構(gòu)圖、界面圖、細節(jié)圖等若干； 2、?針對每一幅圖寫一段話，三五句，講清這幅圖的功用即可； 3、?去掉圖片，通讀全文，做好各段的銜接； 4、?修改文章，直到滿意為止。 一開始我們就多弄點圖，像太平洋電腦網(wǎng)的評測文章一樣。慢慢地，圖的數(shù)量降下去，文字的數(shù)量升上來。最終，您終于修練成Word無圖而心中有圖的不二法門，就神功已成了！ 回眸說明文 咳，大家都還記得說明文是我們學(xué)習(xí)過的眾多文體之一。但作為一個技術(shù)博客的作者，寫的文章大多應(yīng)該是說明某一種技術(shù)（或算法或架構(gòu)）實現(xiàn)。因此掌握說明文的寫作有著舉足重輕的意義，在繼續(xù)下一步之前，我們有必要再復(fù)習(xí)一下說明文的一些要素。 說明文是解說事物、闡明事理的文章體裁，最重的是要把特征、本質(zhì)和規(guī)律講清楚明白。說明文通常都具有知識性，這種知識可能來自于文獻資料、研究數(shù)據(jù)或者自己的實踐和調(diào)查所得。說明的時候要有一定的條理性，也就是順序，必須搞事物特征或者人的認識規(guī)律來安排。知識性和條理性方面最好的范文就是各種藥物的說明書了。在這里有一份“小兒甘草鋅片”的說明書http://www.chinapharm.com.cn/html/database/drugmanual/730/TYV30243701092005KPD.html，如果大家對照葫蘆畫瓢，把自己要分享的技術(shù)（或算法或架構(gòu)）以這種填表式表達出來，未嘗不能達到清晰明了的效果。您可能會笑話我竟然把技術(shù)跟藥品混為一談，并認為他們風(fēng)牛馬不相及，但我給你舉個例子，你看看有著最完善的技術(shù)文檔之稱的MSDN，是不是像極了藥品說明書？下面看個.net類庫里的Keyboard類的文檔：http://msdn2.microsoft.com/zh-cn/library/microsoft.visualbasic.devices.keyboard(VS.80).aspx，語法、備注、示例、層次、安全、版本和參考信息，一類一類列下來，簡明清晰，我等學(xué)習(xí)的典范。 說明文主要是說明事物給人知識，所以既可以寫得平實（如MSDN），也可以寫文藝化一些（如我的博客上的《Mixn掃盲班》http://blog.csdn.net/lanphaday/archive/2007/06/18/1656969.aspx）。說明的方法有下定義、作詮釋、作比較、打比方和分類別等等，具體的可以再參考當(dāng)年的教科書。 十句作文法 上面廢話了這么多，難得您還能忍著嘔吐感看到這里。為了報答您對我的賞識，我決定在這一節(jié)開始白話一下我的兩個獨門密招：十句作文法和測試驅(qū)動寫作。咳，雖然我號稱獨門，不過據(jù)我所知，用這兩招的人非常多，相當(dāng)多；特別是苦難的高考期間緊張在黑色六月的祖國的花朵們，經(jīng)常用這兩招。 十句作文法不是我原創(chuàng)，是中學(xué)的時候，我的英語老師教我的。那時我數(shù)學(xué)經(jīng)常考一百分，語文就差了點。我的老師看在眼里急在心里，為了培養(yǎng)一個能文能武的學(xué)生，他在某個冬日的午后，在痛批恨鐵不成鋼之后把這個獨門秘方傳授于我，從此我就走上了作文高分之路。 首先要指出的是十句作文法并不是一定要寫十句，通常是8－12句。這種方法對付考試是最有效的，但也可以應(yīng)用在我們的技術(shù)文章寫作當(dāng)中。十句作文法其實是最低階的寫作方法，汗，我在前面似乎把它吹得太神乎了？因為十句話往往只有200個字左右。200個字能說清楚些啥啊？沒關(guān)系，只要我們不停地迭代（不知道什么叫迭代？）和遞歸（不知道什么叫遞歸？）應(yīng)用這個方法，200個字也能清易擴展到2000個字。古龍曰過了，最簡單的，就是最有效的。 文章就像水，沒有固定的形狀。不過，文章也像水，有源頭、有主體和終端；就像再長的河流也最終也要流入大海，再長的文章，也逃不過“始、中、終”三個字。只要我們掌握了這一點，自然就能一切通殺了。 有了上述理論（氣宗）指導(dǎo)，下面十句作文法（劍宗）就顯得相當(dāng)簡單了： 始（第一段）： ?????? 主題句一句，通常應(yīng)用開門見山法。 ?????? 擴展句一句，用以深化主題，通常應(yīng)用烘云托月法。 中（第二段）： ?????? 簡介一句，通常應(yīng)用承前啟后法。 ?????? 下面用時間、空間、邏輯、總分、并列或者因果等法講述事物/事理，共六句。要用的方法有彩線穿珠、小中見大、順應(yīng)時空、尺水興波和聯(lián)想對照等。 終（第三段）：
?????? 結(jié)束句一句，用以總結(jié)全文、升華主體思想，最典型的做法是：啊，多么偉大的中國人民啊，他們創(chuàng)造了與世無匹的世界奇跡！ 有了這十句之后，我們就可以以小段為大段，以句為小段，對每一句再應(yīng)用一次十句作文法，文章自然就體積脹大，而且結(jié)構(gòu)分明，看起來蠻像一回事了。（附注：如果有讀者正在考英語四六級之類的考試，十句作文法絕對可以幫到你！） 本文最初發(fā)表于戀花蝶的博客（http://blog.csdn.net/lanphaday），歡迎轉(zhuǎn)載，但請務(wù)必保留全文完整，不得用于商業(yè)目的。 測試驅(qū)動寫作 雖然十句作文法是老師傳授于我，但測試驅(qū)動寫作卻是明明白白的我的原創(chuàng)。證據(jù)？還真沒什么證明，不過在百度上搜索”測試驅(qū)動寫作”，找到的網(wǎng)頁數(shù)目為零，也算是一個證據(jù)了吧？http://www.baidu.com/s?ie=gb2312&bs=%BF%AA%C3%C5%BC%FB%C9%BD&sr=&z=&cl=3&f=8&wd=%22%B2%E2%CA%D4%C7%FD%B6%AF%D0%B4%D7%F7%22&ct=0 測試驅(qū)動寫作的靈感來自于編程界流行的測試驅(qū)動開發(fā)（Test Driven Development，簡稱TDD），簡稱TDW。因為TDW和著與TDD相同的血統(tǒng)，所以TDW也有著TDD的優(yōu)勢。文章簡潔可用是TDW的目標(biāo)，它通過先思考如何撰寫文章，并羅列相關(guān)的問題要點，然后再寫出文字；通過比對問題要點，循環(huán)修改添加其它觀點，直到文章完成。大家都是程序員同行，TDW的優(yōu)點我就不說了，請參考大家耳熟能詳?shù)腡DD優(yōu)點；下面我只是談?wù)凾DW的過程： 1）?明確要寫的主旨和內(nèi)容，最好是列一個提綱。 2）?在表格上寫明這篇文章要達到的目標(biāo)、效果、字數(shù)甚至體裁和段落，作為測試用例。 3）?利用十句作文法（或者其它方法）快速完成一個文章原型。 4）?針對測試用例比對，記錄下未完成和完成得不好的地方（Bugs）。 5）?修正Bugs，然后再回到第4步 6）?對文章進行重構(gòu)，潤色。（放到blog上的話，這一步可以不做） 7）?文章完成。 由TDW的過程可見，十句作文法是TDW的基礎(chǔ)，要進行TDW，必須有一種快速的原型開發(fā)方法。TDW是對十句作文法的擴展和迭代，是彌補十句作文法寫的文章有骨無肉缺陷的有效手段。只要掌握了這兩種方法，肯定能寫出受人肯定的技術(shù)文章，為自己的博客添光彩。 Next Works 詩人陸游《示兒》詩中說：“詩為六義一，豈用姿狡獪。汝果欲學(xué)詩？功夫在詩外！” 是啊！云對雨，雪對風(fēng)，晚照對晴空。要學(xué)會這些套路并不是難事。就像武學(xué)一樣，在學(xué)會長拳通臂之后，講究的是融匯貫通。無敵寂寞到左右手互博的周伯通也打不過楊過單手黯然消魂掌，是因為楊過已經(jīng)把他對生活的感悟融進了功夫之中。李杜兩人領(lǐng)銜中國詩界一千余年無人出其右，也正是因為他們的詩已經(jīng)融入了他們對生活的感情！放翁一句“春如舊，人空瘦，淚痕紅浥鮫綃透”讓多少人為之淚流，也是因為《紅酥手》這首詞融入了他幾十年的情感！ 相信通過我的文章，讀者能夠掌握一些寫作的方法和技巧。也許在一段時間之后，您也喜歡上了寫博客，喜歡上了與大家分享自己的所得所思。這時您可能想把自己的文章寫得更有文采一些，也許您仍然會回來問我，希望我再跟您交流經(jīng)驗。我在這里先說一句吧，我不是大文豪，如何把文章寫更富有文采和風(fēng)格，那不是我能回答的問題。我只有一句話也大家共勉： 功夫在文外，文章不夠好，歸根結(jié)底是因為對生活的積累太少。 相關(guān)文章 程序員必知必會之maillist篇 http://blog.csdn.net/lanphaday/archive/2007/06/27/1669326.aspx 程序員必知必會之Email篇 http://blog.csdn.net/lanphaday/archive/2006/06/29/850059.aspx

總結(jié)

以上是生活随笔為你收集整理的程序员必知必会之blog篇的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。