來源:http://droidyue.com/blog/2016/06/19/how-to-write-an-awesome-post/

首先，這算是一篇回答知乎問題 程序員怎樣才能寫出一篇好的博客或者技術(shù)文章？的文章。

什么是技術(shù)文章

這是一個(gè)超級(jí)簡(jiǎn)單的問題，技術(shù)文章通常是指的涉及技術(shù)（這里指的是程序設(shè)計(jì)）的文章。

技術(shù)文章可以是

• 原創(chuàng)文章
• 翻譯文章，如最常見的翻譯英文文章
• 一篇闡述問題相關(guān)的文章
• 一個(gè)系列的文章，如教程。

為什么寫技術(shù)文章

寫技術(shù)文章的目的據(jù)不完全統(tǒng)計(jì)，如下

• 備忘
• 幫助他人
• 知識(shí)體系積累
• 知識(shí)變現(xiàn)
• 提高知名度，成為大牛，網(wǎng)紅

其中，出于備忘這個(gè)目的，適合書寫類似工具使用類的文章，比如Android簽名相關(guān)知識(shí)整理

幫助別人這個(gè)應(yīng)該是必須的，但是這個(gè)其實(shí)并不簡(jiǎn)單，因?yàn)橛行r(shí)候文章的觀點(diǎn)有誤，可能誤導(dǎo)了別人，結(jié)果反而適得其反。

知識(shí)體系積累，如果是處于這個(gè)目的的話，其實(shí)寫文章應(yīng)該是把知識(shí)研究明白的附屬產(chǎn)物。如果是站在這個(gè)角度，想要寫出一篇文章就需要對(duì)涉及的內(nèi)容要徹底掌握和吸收，行文也要嚴(yán)謹(jǐn)，觀點(diǎn)需要反復(fù)斟酌。

知識(shí)變現(xiàn)這是一個(gè)有意思的話題，尤其是對(duì)于一些剛剛開通博客不久的人來說，一提到這個(gè)話題便熱血沸騰。然而真正實(shí)現(xiàn)這一目標(biāo)的一般都是持久經(jīng)營(yíng)博客的作者。除了付費(fèi)翻譯變現(xiàn)快之外，想要靠博客變現(xiàn)必須要經(jīng)得起時(shí)間的積累，而且是優(yōu)質(zhì)的技術(shù)文章的長(zhǎng)時(shí)間積累。

16年的關(guān)鍵詞之一就是網(wǎng)紅。寫博客或者文章也是成為技術(shù)大牛和網(wǎng)紅的一種途徑。在這其中，持續(xù)不斷的高質(zhì)量文章產(chǎn)出是成功的不二法則。

什么是好的技術(shù)文章

• 好的文章必然得到很多肯定，如果你準(zhǔn)備閱讀一篇幅很長(zhǎng)的文章，不放先跳到評(píng)論部分或者分享量，看一看其他讀者對(duì)本文的評(píng)論，再選擇繼續(xù)還是放棄閱讀。
• 技術(shù)文章的目的是幫助讀者答疑解惑，而一篇好的技術(shù)文章能夠以很輕松易理解的形式講明白一件事。

選題

選題對(duì)于文章來說很重要，它影響到了你的文章的閱讀量。通常情況下選題有兩種歸類

• 以讀者需求為導(dǎo)向
• 以個(gè)人研究為導(dǎo)向

以讀者需求為導(dǎo)向，通常的選題為

• 新技術(shù)的教程，比如Android Studio系列
• 某些熱門的技術(shù)和工具
• 某些技術(shù)的系列文章，比如內(nèi)存泄漏專題
• 雞湯文章，這可能是讀者最愿意讀的系列

以個(gè)人研究為導(dǎo)向的，通常選題比較有限，個(gè)人覺得這方面一般多為技術(shù)細(xì)節(jié)，比如ThreadLocal的原理等

結(jié)構(gòu)清晰很重要

有一個(gè)清晰的結(jié)構(gòu)是很重要的，一篇文字密密麻麻的文章，通常不會(huì)太好。

關(guān)于結(jié)構(gòu)，建議使用Markdown更好管理結(jié)構(gòu)。

通常我一般使用#標(biāo)簽和無序的*來處理文章結(jié)構(gòu)，示例如下

1 2 3 4 5

##section的標(biāo)題 * abc * def * ABC * DEF

除此之外

• 盡量避免一段很長(zhǎng)的段落
• 段落之間建議增加一個(gè)空白行

代碼高亮是對(duì)讀者的基本尊重

作為技術(shù)文章，代碼通常應(yīng)該是必不可少的。既然有了代碼，就必須要高亮展示。

聆聽他人的反饋

建議文章的發(fā)布平臺(tái)都配備必要的反饋評(píng)論組建，因?yàn)樗梢詭椭闶占竭@些有效的反饋

• 文章中的錯(cuò)誤
• 解決問題的其他方法或者是更佳的方法
• 別人對(duì)你的文章的正向肯定評(píng)價(jià)
• 批評(píng)和建議

耗時(shí)問題

聽見過很多人為什么沒有堅(jiān)持寫博客下來，大多數(shù)回答是沒有時(shí)間。可見，寫博客是很需要時(shí)間的。尤其是產(chǎn)出一篇好文章。

我認(rèn)為一篇博文的耗時(shí)可以分為兩個(gè)階段

• 研究階段（閱讀查閱資料并咀嚼消化）
• 書寫階段（將研究階段的成果以圖文形式輸出）

對(duì)于研究階段的一些實(shí)踐

• 將技術(shù)切分成點(diǎn),比如研究ThreadLocal，我們可以切分成ThreadLocal的用途，使用方法，內(nèi)部實(shí)現(xiàn)原理等
• 切分成技術(shù)點(diǎn)之后，我們可以利用碎片時(shí)間對(duì)這些點(diǎn)逐個(gè)研究
• 研究的參考資料推薦官方文檔，StackOverflow和英文技術(shù)博客

完成了研究階段之后，就是書寫階段了。

通常情況下，我自由寫作時(shí)間主要集中在以下兩段時(shí)間

• 周末
• 平時(shí)的早起時(shí)光（一般為6點(diǎn)開始到上班通勤之前）

這里建議書寫階段最好是一個(gè)持續(xù)的時(shí)間，減少間斷寫作帶來的回憶成本。

拖延癥問題

拖延癥已然成為了現(xiàn)代人的一種通病，寫篇博文也或多或少碰到它。

通常我一般的拖延癥表現(xiàn)為

• 提筆前，各種刷新聞，逛知乎，卻遲遲不肯動(dòng)筆
• 寫作中，忙里偷閑，刷微博，看朋友圈

關(guān)于如果解決，通常的做法就是強(qiáng)迫自己，做到克制，緩解并解決強(qiáng)迫癥需要慢慢來，循序漸進(jìn)。

關(guān)于拖延癥，有一本書，大家可以選擇去看以下。戒了吧！拖延癥：寫給年輕人的拖延心理學(xué)

關(guān)于翻譯

翻譯也是寫作博文的一種，對(duì)于技術(shù)文章通常是把英文翻譯成中文。有過翻譯經(jīng)歷的同學(xué)都有過這樣的感悟。

翻譯最痛苦的莫過于知道句子意思，卻找不到信達(dá)雅的語句表達(dá)出來。

我認(rèn)為解決上述痛苦的方式有兩種

• 學(xué)習(xí)翻譯技巧
• 多閱讀相關(guān)的翻譯，從中吸取精華

之前，一位負(fù)責(zé)對(duì)我翻譯審校的前輩向我推薦過一本書，叫做翻譯的技巧 如有需要，建議閱讀。

究竟怎么才能寫好

其實(shí)寫好一篇博文不容易，但是我覺得做到以下幾點(diǎn)應(yīng)該就能產(chǎn)出好文章。

• 把復(fù)雜的事情講簡(jiǎn)單
• 文章結(jié)構(gòu)做到清晰
• 多多寫作，熟能生巧，寫多了就有感覺了。

本文觀點(diǎn)僅為個(gè)人觀點(diǎn)，希望能對(duì)人一些幫助。歡迎留言評(píng)論一起探討，共同學(xué)習(xí)進(jìn)步。

總結(jié)

以上是生活随笔為你收集整理的程序员怎样才能写出一篇好的技术文章的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

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