天天看點

周末雜談:如何寫技術部落格文章的體會

背景

  • 技術文章的高品質主要展現在技術主題的明确、結構清晰、最重要就是幹貨滿滿。
  • 為了達成這些目标,作者在構思文章時,需要考慮以下問題:如何将碎片化的知識變成體系化的輸出?主題怎麼寫?如何建構知識架構?知識會不會有錯誤,如何排查?在這個過程中,其實也是理清知識脈絡的過程。

主題明确

主題一定要明确,不僅文章标題就要切合,文中的小标題的命名也要點題明确。

  • 如果你想寫一篇多線程的入門文章,那主題可以是這樣的:
  1. 《記Java多線程程式設計的第一次實踐》
  2. 《看了這個有趣的例子,你就秒懂多線程同步了》
  3. 《Java多線程入門概念整理》
  • 如果你整理了很多Spring架構相關的筆記,需要把這些筆記整理成一篇技術架構文章,那主題可以這樣寫:
  1. 《Spring架構學習筆記十二篇》
  2. 《Spring架構總結與項目實踐》

結構清晰

  • 确定好主題後,再梳理思路,根據主題将正文的核心部分羅列出來。有個比較通用的結構模闆,比如:

一、背景/前言

二、由于什麼原因,我們要做什麼事情…

三、遇到的問題/面臨的挑戰

四、遇到了什麼問題(成本、時間、難易程度)…

五、 如何解決?思路&方案介紹

六、業務有什麼方案?适不适合我?我打算如何做?我的切入點是什麼?

七、實踐的過程&解決了什麼問題

八、實踐過程遇到了什麼問題,如何分析解決的?能否沉澱輸出比較通用的方法論?

九、 總結&經驗&教訓

十、對這件事&項目的總結,收獲的教訓&獲得的經驗&總結

十一、 展望&未來規劃

幹貨

  • 主題與結構都理清後,接着就是填充内容。内容最好是自己在技術學習與項目經曆中實際發生的總結:加入資料、截圖、簡練的代碼與注釋,項目中碰到的問題與解決方法讓文章具有現實感與臨時感,這樣有血有肉的文章才會真正讓人覺得幹貨滿滿。

舉例: