如何寫一篇好的技術博客

        在工作過程中，發現對很多東西都一知半解，不是很透澈，到頭來很容易模糊，如果有一篇好的技術博客予以總結，一來即使忘記了，回國頭來再看，仍 然能夠從自己的思路中恢復；二來總結一下，還會發現一些潛在問題；三來，有利于大家交流技術。很多大公司都有自己的內部技術博客平臺，寫好自己的技術博 客，對一個技術人員來說，也有一定的成就感。

        在網上查閱資料，經常可以看到一些技術博客，要么廢話連篇、排版紊亂，要么代碼占了篇幅的 60%，有些甚至是錯的，會讓人產生誤解。因此，在這總結一下一篇好的技術博客應該是怎樣的，同時也規整自己的不良習慣。本篇博客純屬個人的一點想法，是 個原則性的東西，切忌逐條對號入座啊。

        本篇博客耗時 2 小時。

        一、帶著明確的目的寫博客

        經常看到這種博客，為了寫博客而寫博客。比如一篇介紹 socket 接口的使用方法的博客，羅列了一堆代碼，湊上幾句話：“首先…，其次….，最后…”，就算 OK。如果你的目的是“練習如何使用寫博客的軟件”，或者“羅列接口”，甚至“練習寫作的方法”，那么可能達到了目的。但是我想，寫一篇技術博客，首先是 要明確該博客的目的，通常是學習一項技術、解決一個技術問題什么的，比如“學習 Linux 內存管理機制”，“解決 kernel pannic 的問題”，“打發時間”等。

        不是所有的的事情都要寫一篇博客來記錄，要有自己的判斷什么東西值的寫，什么東西不值的寫。

        二、寫自己的博客

        網上相互轉載的帖子很多，一篇寫的不錯的博客經常會被轉載，建議不要輕易轉載別人的帖子，要寫自己的博客。同樣一個知識點，或者同樣一個問題， 你的理解和別人的理解的程度很可能是不一樣的，如果輕易的看過以后轉載了別人的博客，可能意味著一次自我學習或體會的機會的放棄。可能有人會說：”同樣一 個 GFS 的架構圖，我畫也是這樣，他畫也是這樣，因為 GFS 就是這樣設計的“，這里并不是要求任何一個細節都自己去做，而是要有自己的想法、自己的理解，比如 GFS 分層的原則是什么？為什么這樣分層，分層的好出？如果我要是去做的話，我會怎么搞？

        寫自己的博客可不是意味著不轉載別人的，比如說我看了一篇博客，并且經過實驗，卻是與博客里面寫的完全一致，不多也不少，如果要是自己的寫的 話，也會寫的基本一樣，那就沒必要再花費時間自己寫了。另外，以及純粹記錄性的博客，可以轉載，比如“C語言運算符的優先級”，當然轉載還是原創都不重要 了。

        另外，把別人的好的博客作為自己的原創，不但沒品，而且自欺欺人。

        如果在博客中參考了別人的博客，可以在參考資料里面提及，如果是完全轉載，也應注明轉載出處。

        三、博客是總結，不是過程

        寫博客有的時候是一個解決問題的過程。為了解決一個問題，今天采用了a方法，發現不行，明天采用了b方法，發現也不行，后天采用c方法，發現行 了， 那么最終的博客應該是在c方法解決問題后，開始寫的。當然，前面的a，b方法，是需要做記錄的，但只是博客的原始材料，而不是博客本身。

        在剛開始寫博客時，我經常出現這種情況：對一個技術不清楚，想了解一下，就開一篇技術博客，邊查資料邊填寫博客，結果基本上就是讀、復制、粘 貼、 讀、復制、粘貼…的過程。最后落到自己手里也是空空如也，想起一句諺語：“狗熊掰梆子——掰一個丟一個”，在懊惱自己的緩存為什么這么少的同時，我也想是 否是方法不對？后來我想過，要想掌握一項技術、知識，大概需要這樣一個過程：實踐遇到問題——理論學習問題——實踐解決問題——理論總結問題。我想很多情 況我是缺少了其中的三個部分，只有“理論學習問題”的過程。

        后來，我就改成按下列步驟寫博客了：

• 碰到了問題，如果解決不了，而又比較有價值的話，就先記錄下來，作為一篇博客的開篇。
• 首先，先自己分析問題，基于已有的現象，思考，在筆記本上記錄問題與可能的思路。
• 其次，從外界獲取經驗或者知識，比如請教別人，google 等，學習他們，在筆記本上記錄關鍵點。
• 然后，在實際中用學來的方法去解決問題，筆記本做好記錄，要像水流過水渠一樣流淌前面記錄的思路。
• 最后，拿過筆記本，將以上過程再總結成一篇博客。

        當然，并不是所有博客都能夠先從”實踐遇到問題”開始，因為很多情況下都是先從書本理論開始學習的（這也就產生了一定的局限性，有時候你學的很 好， 反而陷入了固有的框架；有時你學的不好，顯得自己更加無知）。這種情況，問題是需要自己總結出來的，比如 ULK 上會介紹中斷和異常的處理機制，這包括中斷的過程、CPU 的工作、內核的工作、軟中斷的處理、tasklet 等等，我們學習中斷，不僅僅是一旦發生中斷，Linux 內核是按照什么流程去處理，而是要找到這么處理的原因，也就是解決了什么問題。有時，實踐驗證的成本過高，在有條件的前提下做吧。

        知識開始學習的時候，經常是只見樹木，不見森林。俗話說：”孤木不成林“，弄上三五棵樹，才會有”森林“的感覺。

        四、盡量拒絕三手技術

        在實際學習或者工作中，一個問題不明白，那么就需要請教別人。如果能夠從周圍的高手、牛人那得到簡單、直接的答復，那是最好的。如果不能，就需 要自己在網上查找資料，可能一個問題，林林總總的在網上能搜出很多，選擇看哪些就是個問題。盡量去選擇原發性的材料，如果你在查 gcc 的一個編譯選項是什么意思，可以使用 man 手冊，如果還不清楚，就去 gnu 的官方站點去查，最好不要隨便從某個轉載的技術博客上獲取。如果你要找 x86 平臺 CPU 訪問內存的方式，應該從 Intel 的官方站點去找 CPU 的資料，最好不要隨便在網上找篇博客看了拉到（起碼應該先看官方材料）。

        別人的博客自然帶有別人的理解，而這種理解可能帶有一定的主觀性，有時甚至是錯誤的，應該養成從原產地采購的習慣。如果哪天能夠發明一項技術， 那么這算一手技術；如果你在學習一項成熟的技術，那么該技術就屬于二手技術了，如果你再從一個非源發性的地方去學習，那么很可能就是“三手技術”。當然， 需要考慮實踐成本，有時實在找不到源發性的材料，也不要太勉強自己了。另外，英文文章的水平整體高于國人的文章水平，應該盡量看英文文章。

        五、分清主次、落腳關鍵點

        世界萬事萬物都有聯系，凡是和本篇博客的主題有聯系的問題，都在本篇博客中描述，是不現實的，也是沒必要的。個人認為，一篇技術博客應該不超過 兩個主題，如果超過了，就應該拆分。但是次要問題可能會有不少，這些次要問題不一定都要解決掉，但一定要分清除優先級，和主題關系比較大的，應首先解決， 關系小的，應其次解決，甚至并不在本篇博客中解決。對于沒有解決的問題，可以列在”遺留問題“中，對于在其他博客中討論的問題，給予鏈接。

        根據自己的能力，耕耘到合適的層次。我將掌握一項技術劃分為如下層次，在博客中通常應該達到第三個層次：

• 聽說過該技術，了解該技術解決什么問題；
• 使用過該技術，熟悉該技術的使用方法；
• 解構過該技術，熟悉該技術的架構、原理；
• 貫通過該技術，將該技術與自己的以有知識完全融合，可以利用該技術架構或解決其他問題。

        六、技術博客的風格

• 技術博客不是論文，技術博客由其實用性。當然，也有將論文發在博客上的，比如技術博客的作者大部分應該是工程師，而不是學院派。一篇技術博客可以 是小到的一個編程技巧，可以寫該技巧的原理、實現方法、好處，但不要寫前 500 后 300 年的歷史介紹和展望未來。技術博客通常關心技術的實用性，而非技術背后理論的復雜性。技術博客也不應該過分求全責備，把文章寫的大而全，而應該追求小而 精。
• 技術博客應以陳述語氣，個人感情色彩應該過濾掉，技術不是生活的全部。有人寫技術博客，常喜歡加入自己的心情，“xxx 讓我好煩啊”、“xxx 很難，我一直持續搞了兩天沒睡覺”，我個人拒絕這種“呻吟”的風格。
• 忌羅列代碼。代碼是實現的過程，而不是原理，列代碼是為了看清流程，而非為了列代碼而列代碼。我個人的習慣是盡量少列代碼，如果能夠使用校小的篇幅就能說明原理，絕不使用大篇幅的代碼。但是如果簡單的羅列代碼能夠一目了然，也絕不浪費過多的筆墨去描述過程。
• 圖片勝過文字。圖片配文字比單純的文字更加方便理解，甚至一張圖就可以省略文字了，多畫圖，少寫字是個原則。
• 考慮時間成本。博客基本上是以時間換知識，因此需要越來越快，記錄時間也很必要。
• 列出時間遺留問題，以備以后解決。

                    <span id="shareA4" class="fl">                          </span><ul>

</ul>

</div>