7. 技术博客的开头，中间，结尾都该怎么写？

你的名字 2022-10-12 12:09 61阅读 0赞

> 橡皮擦，一个逗趣的互联网高级网虫，为你带来新职场故事，搬来程序员敲门砖。

## 已完成文章 ##

*  [国内，首套，成体系，技术博客写作专栏发布啦][Link 1]
 *  [技术博客只能写技术文章吗？当然是由我们自己来定义。][Link 2]
 *  [为“她”而写的技术博客，是怎样的？][Link 3]
 *  [你也要写技术博客？这篇博客告诉你平台怎么选][Link 4]
 *  [写第一篇博客，最好的时间是今日，今时，今刻][Link 5]
 *  [如果你也要写博客了，看看本篇博客中提及的选题吧][Link 6]
 *  [技术博客的标题怎么写，竟然真的有套路][Link 7]

> 本文内容：博客内容与行文框架  
> ![技术博客的开头，中间，结尾都该怎么写？][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hpaGVsbA_size_16_color_FFFFFF_t_70]

## 技术博客的内容与行文框架 ##

### 内容怎么写 ###

一篇好的技术博客，一定是人为加工出来的，这里就涉及到了文章框架，文章开头与结尾都如何设计，如何去写。

在文章开始，先给大家提供一些，与内容写作有关的小提示。

1.  技术博客写作，优先使用 Markdown 格式写作，富文本写作的时代已经过去；
2.  要学会分段，多分段；
3.  掌握总分总写作结构；
4.  每篇博客的字数，控制在 1500~2000 字以内（特殊情况除外）；
5.  写作前，提前准备大纲，例如本系列课程开篇的脑图。

更多的写作细节内容，可以阅读一个神奇的开源项目：[中文技术文档的写作规范][Link 8]，必有所得。

### 开头怎么写 ###

上篇博客，橡皮擦带你简单学习了一下标题的套路，本篇上来带给你如何写好 “套路” 型的开头。

博客的开头，只有一个目的，就是让打开本文的读者，阅读下去，所以开头你可以这样写：

**陈述一件事情+提出问题**

例如：

今天我碰到了一个缓存 BUG，我是这样解决的。

下班我还没有走，还在处理一个文件读取 BUG，好想知道技术组长是怎么解决的？

MySQL 读取 1W 数据，需要 10 秒，如何才能优化到 1 秒呢？

**设置悬念+引发好奇**

例如：

要不是处理了这个乐观锁，我可能就离职了！

技术总监在全员大会上，“狠狠” 的夸了我，就因为我完成了一个陈年大 BUG。

**直接告诉读者收获**

例如：

学完本文你能掌握如下技术。

本文将通过 Python 爬取腾讯动漫数据。

**反常理描述**

该类型与 **设置悬念+引发好奇** 殊途同归，为激发读者兴趣。

例如：

为何我把数据库读取速度减慢？

为什么上线前，我把秒杀按钮缩小了？

**对话开头**

该种形式的文章开头，是上述内容的一个综合应用，目的在于让读者，能感受到一个真实存在的场景。呈现方式可以直接文字展示，也可以微信/QQ 窗口截图。

例如：

小李：总监，我这个并发一直处理不好？  
总监：……

> 一个好的开头，可以让读者顺利从标题，过度到你的文章内容上来，并且可以引导读者继续阅读。  
> 一个好的开头，是文章标题的延伸，甚至是一个点睛的副标题。

### 结尾怎么写 ###

结尾核心的目的总结全文，如果能激发读者思考，或让读者阅读更多的文章，或者能让读者产生文字交流的欲望，那结尾就发挥了最大价值。

一般结尾按照如下方向写作即可。

1.  总结文章知识点，并进行扩展；
2.  提供更多的阅读资料，增加其它文章的曝光率/阅读率；
3.  提出新问题或其它方案，让大家探讨；
4.  附录一个源码下载地址，共大家学习；
5.  也可号召让大家收藏，点赞你的文章。

一定要注意，文章不要突然刹车，即使结尾只有短短的一句话，也要优于 **无**。

### 内容怎么写 ###

开头与结尾在一篇博客中，占的篇幅很小，重要的还是主体内容部分。毕竟好内容，才能决定一篇文章的好坏。

在内容部分，橡皮擦给你的建议如下：

1.  尽量分段；
2.  减少大段代码，代码越多，阅读体验越差；
3.  给仅有的代码增加注释，清晰的注释；
4.  适当增加图示说明；
5.  使用列表，表格。

好的内容也依托于行文风格，你可以从临摹别人的风格开始。

1.  漫画型，需要一定的美术基础；
2.  故事型，让文章从一篇故事开始，以故事 Happy Ending 结尾；
3.  对话型，通过 A 与 B 的对话，阐述技术点；
4.  逗趣型，内容，语言搞怪，可通过表情包表述心情；
5.  纯技术流/学术派，扎实的理论基础；

行文风格，可以不断尝试，最终得到最适合自己的风格，也可以多种进行组合，或者开拓新的写作方式。

有两点需要注意：

全文都是图片，不易被搜索引擎收录。

全篇都是代码，会给读者造成极大的阅读障碍。

### 写在后面 ###

开头，内容，结尾，总分总，技术博客写作基础框架，希望本文能对即将开始写作的你，有所帮助。

本文完。

> 2021 年 7 月 4 日 梦想橡皮擦，发布于河北石家庄。  
> 下一篇主题：  
> 技术博客素材收集
> 
> --------------------
> 
> 今天是持续写作的第 175 / 200 天。可以点赞、评论、收藏啦。

[Link 1]: https://dream.blog.csdn.net/article/details/116212101
[Link 2]: https://dream.blog.csdn.net/article/details/116332893
[Link 3]: https://dream.blog.csdn.net/article/details/117200769
[Link 4]: https://dream.blog.csdn.net/article/details/117622075
[Link 5]: https://dream.blog.csdn.net/article/details/117742621
[Link 6]: https://dream.blog.csdn.net/article/details/118086952
[Link 7]: https://dream.blog.csdn.net/article/details/118183396
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hpaGVsbA_size_16_color_FFFFFF_t_70]: /images/20221005/17cdfc22ec9e4d339ddf70cde0ebf67d.png
[Link 8]: https://github.com/ruanyf/document-style-guide