技術(shù)文章如何寫作能讓讀者有較好的閱讀體驗，是一個仁者見仁，智者見智的問題。甚至很多人都認(rèn)為根本不需要考慮讀者的感受，把技術(shù)寫好寫準(zhǔn)確就可以了，這其實就是一大誤區(qū)，你的寫作如果只是給自己看，當(dāng)然我也就不多說什么，但如果你的寫作是給別人看，就一定要考慮如何寫的問題，因為這是一個信息傳遞的過程而不是簡單的記錄。
　　事實上，對于一個準(zhǔn)備開始寫作的人來說，通常是會認(rèn)為自己寫的東西一定是對的。如果一定要完全正確才可以寫文章的話，那就會讓絕大多數(shù)人裹足不前。因此，寫得對不對雖然是作者應(yīng)該首先要把握的，但是無論作者自己還是別人都無法在寫出文章公布之前知道這一點，因此這不是我本文要談的重點。
　　我的核心觀點是： 好的技術(shù)文章，是讓符合閱讀條件的讀者，在良好閱讀體驗的情況下，看懂學(xué)會甚至掌握文章要傳達(dá)的信息。因此，需要寫作中不斷思考，這樣寫，讀者會有什么感受。如果你的寫作不能讓讀者有一種收獲的喜悅，或者閱讀體驗不佳，那么你的寫作就是有問題的。問題可能會有很多方面，我們一點點分析。
　　要告知讀者文章適合什么人讀
　　首先要告知你寫的文章適合什么人讀，這盡管不是最重要的條件，但你是打算一開始就告訴讀者，這文章的適讀人群，還是讓讀者需要讀完文章后再自己去判斷這文章可不可以看得懂，兩者在閱讀體驗的感覺是完全不一樣的。通常一篇文章對于某個讀者不是太淺，就是太深。正好是自己不了解的技術(shù)知識，自己有興趣，而又能通過閱讀看得懂的文章才是適合的好文章。因此由于讀者層次不同，你的文章給什么人看的定位就很重要。
　　你把你的文章放到了博客園首頁上，那就意味著不管什么層次的讀者都可能點擊進(jìn)去。你如果不告知讀者，這個內(nèi)容至少需要具備什么樣的條件才能閱讀，對于一篇有一定技術(shù)難度的文章，初學(xué)者去閱讀它，怎么可能高興得起來。
　　反之，如果你在一開頭就寫明，此文必須要有A、B、C的知識，否則還是不看為妙，那么誤入的讀者至少可以不需要繼續(xù)往下看，或者有個心理預(yù)期，可能看不懂，不過反正自己也沒到那個層次，沒什么關(guān)系。
　　如果將寫作的具體技術(shù)難度分為九級（九級最高），你打算寫一篇難度為七級的文章。此時，你不應(yīng)該考慮水平在一、二、三級的讀者，而是將四、五、六級的讀者作為目標(biāo)群，因為你的難度應(yīng)該要讓讀者稍微費點力就夠得著的，而不是那種根本看不懂的人，這樣的定位才會更有針對性。如果你寫的內(nèi)容連二、三級讀者都能讀懂，那就說明實在是太啰嗦了，細(xì)節(jié)描述過多。如果只有七級水平的讀者才能看得懂，那通常又是因為描述過于簡潔而忽視了細(xì)節(jié)。這兩種情況你的文章價值都會大大縮水。
　　清晰明白地指出文章適合什么樣的人讀，這有很多方法。可以是標(biāo)題、摘要或者文章開頭，只要達(dá)到提醒的作用，不要去浪費非目標(biāo)讀者的時間就對了。
　　另外，如果可能，還應(yīng)該在文章末尾提供繼續(xù)深入學(xué)習(xí)的建議，比如之后應(yīng)該閱讀什么書，看什么文章等。也就是說，你可以為你的讀者指明了接下來學(xué)習(xí)努力的方向。
　　總之，你在一開頭就告知此文章適合什么人讀，幫助了讀者節(jié)約了判別的時間，這是一個非常好的開始。
　　寫作內(nèi)容的難度層級遞進(jìn)
　　不要一上來就是關(guān)鍵知識點，那雖然是一種風(fēng)格，但卻違背了知識（或者說信息）傳遞的規(guī)律。
　　你在大街上看到了一漂亮姑娘，想讓她成為自己的女朋友，你不能直接上去說“做我女朋友吧”，除非你開著法拉利或許可能。你首先要和她認(rèn)識，并得到聯(lián)系方式。簡單的辦法就是去搭訕。搭訕時如果直接說“給我你的手機(jī)號如何？”顯然也是不合適的，除非你長著貝克漢姆的臉興許可以。所以你得說點不讓人反感的話。比如：“你那iphone如果開啟手勢功能，就不需要頻繁按Home鍵了。不信？你看我的……”
　　舉技術(shù)寫作上的例子。在講算法時間復(fù)雜度的知識點時，你當(dāng)然可以直接講時間復(fù)雜度的定義(就像大多數(shù)數(shù)據(jù)結(jié)構(gòu)教材一樣)，可這是很讓讀者，特別是剛學(xué)的人迷惑的，為什么要強調(diào)這個呢？而且由于一上來就是對大O階推導(dǎo)，理解比較困難，讀者的體驗就相當(dāng)差。
　　我在《大話數(shù)據(jù)結(jié)構(gòu)》書中講解的辦法是先舉了從1加到100的算法例子，對比容易想到的算法和高斯算法的差異，來引入算法優(yōu)劣間的差異，并詳細(xì)解釋了函數(shù)漸近增長的原理，最后再來給出時間復(fù)雜度的定義，以及推導(dǎo)大O階的方法。由于讀者理解了函數(shù)漸近增長的原理，再去理解時間復(fù)雜度就變得容易了，這就是層級遞進(jìn)的作法。
　　運動員比賽前都需要熱身，男女親熱前也需要前戲。同樣，為了讓讀者進(jìn)入閱讀狀態(tài)，用一些簡單的例子來預(yù)熱，用一些稍難的例子來鋪墊，然后引出要講解的重點，這樣可以更好的達(dá)到講解好知識的目的。
　　得用讀者可以理解的語言，而不是你認(rèn)為好的語言
　　微博上有這樣一個段子。一位老太太想知道什么是Facebook，約旦VC Ahmad Takatkah的解釋：
　　1)Facebook是一份報紙；
　　2)這報紙要在電腦或手機(jī)上看；
　　3)報紙里只有家人和朋友的新聞，第2頁是兒子的、第3頁是妹妹的…
　　4)關(guān)于他們的新聞他們自己寫；
　　5)其中有一頁是你自己的，想寫什么想讓誰看你說了算；
　　6)報紙第1頁，是全部內(nèi)容摘要。
　　怎么樣，是不是感覺很不錯？如果為了讓老太太理解Facebook，去提什么這是一家社交網(wǎng)站，它可以向親朋好友分享照片、視頻和個人信息等很IT化的語言，她一定是非常困惑。她可能接著就會問“什么是社交網(wǎng)站”、“什么是視頻”等問題了。
　　同樣，你如果想讓你的讀者閱讀體驗好，就一定要用適合他們的文字，而不是你自己喜歡的文字，哪怕你的文筆相當(dāng)棒。
　　這一條可能是最重要的一點，信息的傳遞最終都是為了讓讀者理解你的意圖。寫作時，一定要時刻想著用適合讀者的語言來表達(dá)。
　　一圖值千言
　　用上千個字描述不明白的東西，很可能一張圖就能解釋清楚。比如我在講解數(shù)據(jù)結(jié)構(gòu)的歸并排序時，寫了很多文字來說明排序的原理，但如果沒有下面這樣一張圖，可能都是遺憾的。很多人也許就在看圖的一瞬間，就明白了前面的迷惑原來就是因為大腦里沒有這樣一個類似的數(shù)據(jù)變換概念造成的結(jié)果。