最近看到很多這方面的文章，我就想了想，我認(rèn)為的好的技術(shù)文章是什么樣的？這文章主要是寫給自己的，對(duì)我以后的技術(shù)文章有警醒作用。

不是讓你在文章開頭寫下，你的文章適合什么樣的人讀？——這是什么意思，鄙視我看不懂你的文章。

我所說的“目標(biāo)群體”是大家，也包括你自己。你的文章是給大家讀的，也是給自己讀的。

大家能看你的文章，應(yīng)該是我們的榮幸，我們應(yīng)該高興?，F(xiàn)在的互聯(lián)網(wǎng)是個(gè)信息大爆炸的時(shí)代，什么文章沒有，能看你的文章，有人關(guān)注你，難道你不應(yīng)該慶幸嗎？

如果大家能在看你文章的時(shí)候，給你寫評(píng)論，那你更應(yīng)該高興，因?yàn)槿思掖_實(shí)看了你的文章。而且如果給你寫一些建議，那你更應(yīng)該高興不已。因?yàn)槟愕玫搅艘馔馐斋@。

你寫的文章，盡量應(yīng)該簡單，明白。——寫技術(shù)文章，應(yīng)該把復(fù)雜的弄簡單，而不是把簡單的弄復(fù)雜，畢竟不是寫書。

很多“牛人”，很會(huì)賣弄風(fēng)騷，把文章寫的跟舊社會(huì)女人的裹腳布一樣，又臭，又長。——有的時(shí)候我也經(jīng)常犯這樣的錯(cuò)誤，雖然我不是”牛人“。

那么怎樣寫的簡單、明了呢？

1、少說廢話，把主題句（關(guān)鍵句）給我們拿出來看就行了，甭寫一堆的廢話。——很多人本來一句話能解釋清楚的事情，用上百行字去讓人明白。這很大程度上也說明他自己也在迷糊中。

2、可以加一些解釋，最多用四句話。——如果超過四句話，說明你還在糊涂中，你就需要“重構(gòu)“了，把內(nèi)容盡量縮短。——畢竟你有時(shí)間看，但不要浪費(fèi)大家的時(shí)間。

3、用圖像把主題意思提煉出來。如果你的圖，能說明你的問題，那你就用圖表示，再加一些輔助的文字說明（這是大家不明白的時(shí)候才看的）

4、技術(shù)名詞給個(gè)連接。——很多人寫文章有個(gè)特點(diǎn)，當(dāng)提到某個(gè)技術(shù)的時(shí)候，先介紹這個(gè)技術(shù)是什么？這用你說嗎？現(xiàn)在的百科，wiki哪一個(gè)說的不比你清楚啊，你只需要給個(gè)連接就行了。

[!--empirenews.page--]

你最好把你最主要、最重要的東西往前排。——畢竟不會(huì)每個(gè)人都看完你的文章。大家都是忙人，還要干別的事呢？哪有心思看完你整片文章。

我記得我想看一些技術(shù)類的書籍的時(shí)候，剛開始很興致勃勃的去買了相關(guān)書籍，結(jié)果我看了前兩章，實(shí)在沒心思再往后看了，這種書我通常用半年或者一年的時(shí)間去看完。畢竟用我辛苦掙得錢買的，如果不看完，心里虧得晃。

但是我發(fā)現(xiàn)，很多開始提不起興趣的書，越到后面越讓我來了興致，越到后面越精彩，越到后面我的收獲就越大。——為什么學(xué)點(diǎn)有用的東西就那么難呢？

你的文章盡量要簡短?？撮L長的文章，跟看長函數(shù)一樣，讓人望而生畏。

如果你的文章很長才能說明問題，那我建議你，可以把文章做成系列，分幾個(gè)系列給大家看。每次回頭想看的時(shí)候，更有針對(duì)性。——這就跟我們寫代碼一樣，不要讓你的類太長，如果太長，那你該重構(gòu)了——Extract Class。

不要以為你能一下就能把你的文章寫好，你也不是完人，就算是再牛的作家，也還要不停的修改他的文章呢？何況你只是一個(gè)coder而已？

我們寫完文章，要經(jīng)常性的翻看自己的文章?？次恼碌倪^程，是我們?cè)僖淮螌W(xué)習(xí)的過程。翻看的時(shí)候，我們自己經(jīng)常能發(fā)現(xiàn)一些問題。如標(biāo)點(diǎn)符號(hào)、錯(cuò)別字、代碼錯(cuò)誤、語病、文章樣式...

盡量配置一些圖片，很多時(shí)候圖片很能說明問題。——如果能配置動(dòng)畫視頻，那就更爽了。很多時(shí)候圖能說明的問題，是文字無法比擬的。

不要害怕自己的觀點(diǎn)錯(cuò)誤，或者技術(shù)錯(cuò)誤，大膽的寫，如果有人給你指正出來，那你就去找資料去核實(shí)下，然后再去改正，這中間你也能學(xué)到很多東西。

不要怕錯(cuò)誤——勇者無敵嗎！