周末杂谈:如何写技术博客文章的体会

背景

  • 技术文章的高质量主要体现在技术主题的明确、结构清晰、最重要就是干货满满
  • 为了达成这些目标,作者在构思文章时,需要考虑以下问题:如何将碎片化的知识变成体系化的输出?主题怎么写?如何构建知识框架?知识会不会有错误,如何排查?在这个过程中,其实也是理清知识脉络的过程。

主题明确

主题一定要明确,不仅文章标题就要切合,文中的小标题的命名也要点题明确。

  • 如果你想写一篇多线程的入门文章,那主题可以是这样的:

    1. 《记Java多线程编程的第一次实践》
    2. 《看了这个有趣的例子,你就秒懂多线程同步了》
    3. 《Java多线程入门概念整理》
  • 如果你整理了很多Spring框架相关的笔记,需要把这些笔记整理成一篇技术架构文章,那主题可以这样写:

    1. 《Spring框架学习笔记十二篇》
    2. 《Spring框架总结与项目实践》

结构清晰

  • 确定好主题后,再梳理思路,根据主题将正文的核心部分罗列出来。有个比较通用的结构模板,比如:

一、背景/前言

二、由于什么原因,我们要做什么事情…

三、遇到的问题/面临的挑战

四、遇到了什么问题(成本、时间、难易程度)…

五、 如何解决?思路&方案介绍

六、业务有什么方案?适不适合我?我打算如何做?我的切入点是什么?

七、实践的过程&解决了什么问题

八、实践过程遇到了什么问题,如何分析解决的?能否沉淀输出比较通用的方法论?

九、 总结&经验&教训

十、对这件事&项目的总结,收获的教训&获得的经验&总结

十一、 展望&未来规划

十二、未来我们打算怎么做?有什么计划,优势&好处是什么?

干货

  • 主题与结构都理清后,接着就是填充内容。内容最好是自己在技术学习与项目经历中实际发生的总结:加入数据、截图、简练的代码与注释,项目中碰到的问题与解决方法让文章具有现实感与临时感,这样有血有肉的文章才会真正让人觉得干货满满。

举例:

周末杂谈:如何写技术博客文章的体会