如何寫技術博客

關於如何寫技術博客網絡上有着無數個版本，每個人都有自己的見解，想寫一篇這樣的文章已經很久了，但是一直不知道如何出手。之所以不知道該如何落筆，一方面是因為我知道這樣的文章很容易引起口水戰，這是我最討厭的事情，另一方面是讓人感覺自己好為人師，雖然自己對技術也有一些積累和心得，但是由於自己就是一個討厭別人告訴自己該干什么干什么的人，己之不欲，勿施於人，所以一直遲遲不得落筆。

直到今天，無意間在網上看到了一篇文檔，這篇文檔叫“跟我一起寫make file”，作者是酷殼的陳皓，文檔不算短，pdf版本的有78頁。剛開始我只是隨便看看，但是慢慢的，我發現這篇文章寫的太好了，由於個人對make file之前有所了解，一口氣花了5個小時的時間看完了這篇文章，但是並不覺得累，原因很簡單，文章寫的非常通俗易懂，完全是人家心得的東西，一看就是行家離手。

看完這篇文章，我覺得我該說些什么，關於寫技術博客的。

首先，什么樣的東西應該寫，什么樣的東西不該寫？

說這個可能會刺痛很多人的神經，有句話是這么說的：學比處於心得，業必歸於專精

如果不是自己有所心得，那么還是不要寫了，不僅自己沒有收獲，浪費了時間，對比人也沒有幫助。

第二，當自己寫博客的時候問自己一個問題？對於要寫的東西，我自己吃透了么，寫博客不是stackoverflow, 不是向別人問問題，通常是自己要闡述某個方面自己的心得，當然並不是說不可以討論，但是討論的前提是you have the knowledge。

第三，對於一篇博文的定位，是知識梳理的，或者新技術的，或者難點易錯的解析等等，定位好了才容易使一篇文章短小精悍，有形有神。

第四，對於博文標配的代碼，最好帶注釋，你是在寫文章，不是在寫代碼，好多人就直接貼一屏的代碼，就成了一片博文，難以理解。

第五，在對於博文闡述的技術進行交流的時候，要盡量避免不禮貌的行為，有些博文的作者文章寫的還行，但是每每和別人交流的時候就動輒罵娘，個人覺得很是不和諧，當然也可能事出有因，在此只是提出來，建議大家不要這樣做。

第六，對於寫博文是某些博主的炫技（就像有錢人炫富），這種炫技是本來很簡單的東西，可能別人只不過是沒接觸過，作者卻把整個東西寫的很復雜，其實他心里很清楚，只不過是故意寫的很深奧，顯得自己很牛。

總結

當然作為寫博客不應該有的情況還有很多種，在此不可能窮舉出來，在某些方面我自己也做得不夠好，寫這篇文章算是對自己的總結和警示，當然也希望大家也思考一下該如何寫技術博客，另外，對於文章中提及的情況，請不要對號入座。最后因為本人討厭口水戰，所有如果是溝通交流，歡迎指教，如果是口水戰，請繞道，對不起，對於沒意義的事情，兄弟沒時間。