如何写好一篇技术博客

笔者：风起怨江南 出处：杰克测评-CSDN博客 笔者原创，文章欢迎转载，如果喜欢请点赞+关注，感谢支持！

导读：非技术博客，非干货博客。篇幅较长，请三思而后读。

目录

一、写博客能给你带来什么？

二、优秀博客的特质？

三、写博客的选择方向？

四、如何写好博客的内容？

五、博客的未来？

如何写好一篇技术博客

前言

篮球论坛有篮球专业科普文章，比如对球员的技术分析，对比赛的战术讲解，对球队未来的展望；

汽车论坛有专业的汽车评测文章，化妆品也有专业的各类测评视频，就连做饭也同样是有详细的烹饪技巧秘籍，等等...

同样，计算机互联网IT相关行业也是有专业的技术文章，这里也可以称为技术博客。

好了废话不多说，其实刚入行的技术人员不管是程序员还是测试人员，又或者是运维小哥哥，在遇到问题时，都或多或少会去查看一些技术博客。

不管是在博客园还是CSDN，又或者是简书、知乎、掘金，GitHub，再或者是个人搭建的博客等等。99%的常见问题都可以在博客上找到解决方案。

无数优秀的IT从业者会将自己遇到的坑，工作中碰到的技术难点，又或者安装软件遇到的报错，搭建环境出现的异常情况，甚至是面试中遇到的问题等等，进行总结并分享到自己的博客上，以供自己和他人进行阅读和交流。

很多博客大牛通过坚持写高质量的博客而出名，甚至获得大厂的面试机会，再者有通过博客粉丝积累、进而实现了全网统一：（主博客——其他博客网站——B站——搭建博客——公众号——GitHub）。通过各个平台可以积累到大量粉丝。

在技术博客的圈子里面有两类的文章最受欢迎，第一类是实战类的问题，描述在实际工作中的问题，解决问题的思路和技巧；第二类就是通俗易懂入门系列文章，方便初学者快速入门。

全网上千万的博客数量真正优秀的技术博客却微乎其微。大量博客要么是转载其他博客，再或者断章取义截取部分没头没尾的段落，贴上一大堆没有任何解决实质性的代码或日志打印，再者就是不知道复制哪里的话，不断地重复别人写好的内容。

一篇博客是否走心，质量的高低很容易去辨别。写博客是一个短期没有收益，长期收益很大的一件事情，但往往是很多人坚持不下来，特别是写博客的初期，刚写完文章没有人阅读会有一种挫败感，影响了后期写文章的积极性。

一、写博客能给你带来什么？

为什么要写博客？

想写好一篇技术博客首先要弄清楚 —— 写博客能给你带来什么？

• 巩固知识

很多朋友通过看看网上视频充电（比如B站），看实体书学习，或者报培训班提升技能，是否有坚持做笔记、做总结的习惯？

写博客最大的意义，就是 重新将细碎的知识归纳整理，转化为属于你自己的知识记忆，不管是面试还是工作中都可以随时从自己的武器库中拿出来。

单纯的做笔记只是单纯的对知识的记录，而写笔记是思考后提炼出来的精华。写博客时，重新对该知识块进行复习，加深自己对技术的理解。为了呈现一篇优秀的博客，要翻阅各种资料，阅读相关书籍，博客，最主要的还是实践。

用心写完一篇博客，会对写内容再一次加深印象。比如将一些面试常见的问题，研究透彻后写成博客发表，如果在面试中遇到类似的问题，可以很自然的用自己的语言去完美解答。面试前扫一遍自己的博客，是不是很机智？

• 遇坑记录

在工作中遇到异常问题是否会有记录的习惯？

学习新技术、新知识点遇到的各种报错的解决方法是否备案？

所有遇到的坑都可以记录下来并整理成博客，用来记录自己的技术轨迹。这样不仅仅在下次遇到该问题时会快速的找到解决方法，同时可以帮助到其他遇到该问题的小伙伴。

• 能力提升

写一篇优秀的技术博客往往要2天或者更多的时间，你要构思，要去考虑到各种问题，多种方法的实现等等。

写的高质量博客越来越多，对文章的把控能力就越强，从而可以提升自己的语言表达能力，在面试或工作中更好的展现和表达。

内容写的越深入，对原理会多些理解。当对一块成熟的知识点有足够深入的理解后，对其他类似的技术知识也能融会贯通，理解学习起来会更加轻松。

• 对外展示

归根到底博客是展示给别人看的，而优秀的博客可以结交更多志同道合的朋友。

一篇好的博客可以收获别人的关注，点赞和收藏，甚至有些人会发评论去感谢大佬。

这一切外人看来举手投足的举动都可以给你带来妙不可言的感觉，就像幼儿园的小淘气们被老师授予小红花一样开心，满足。

而这些满足感会不断地激励你继续产出高质量的博客，技术文章，良性循环，你博客的内容会写的越来越好，而你整体对外呈现的就是名副其实的大佬姿态。

久而久之，你的博客也就是你的另一份简历，有些面试官会通过访问到你的博客，看到你的粉丝关注数和文章的收藏量，再点进去看到非常优秀的内容，自然而然会对你有强烈的好感。至少会觉得你是一个热爱学习，热爱进步，积极向上充满正能量的real大佬。

字如其人，其实博客更如其人。博客展示了个人对技术、对生活的理解。技术博客是了解一个技术人最好的方式之一，经营好博客，就是经营好对外的形象。

二、优秀博客的特质？

• 标题引人

不得不说，一个夸张的标题很容易吸引到别人的眼球。

比如《python装饰器的学习笔记》和《装饰器很难？带你轻松掌握装饰器用法》，如果内容一样，这两个标题你更想看哪个？

其实很多博客大佬的标题都多多少少带着一些夸张的手法，毕竟现在程序员以85后，90后甚至95后为主力军，一些好玩、生动的标题的确很吃香。

当然技术博客还是以内容最为重要，如果内容不好，再酷炫的标题也不会获得任何好评。

• 内容干货

内容不要复制太多别人的内容，不要原封不动将书里的内容写在博客里。可以作为摘要将一小部分内容当作资料穿插在博客中。

这里是摘要，写别人说的内容。

内容一定要深入研究，不能停留在表面。

比如要写《requests库的用法》这种博客时，一定要去将源码过一遍，将源码和注释理解透彻，再去参考下官方文档，结合其他优秀的教材或视频对requests库用法的理解，再将整体文章框架搭好。

部分细节内容要不断地敲代码去尝试，考虑多种效果、多种实现方法，最终将所有整理的内容放在博客中。

一篇博客要花费精力去完成，不仅考验你的能力，对知识的理解，同时也考验你的耐心和对文字的把控。要通过不断地练习和积累，逐步去将自己写的博客变得干货十足！

• 通俗易懂

内容都是难懂的干货也不行，要转化中自己的口语。将复杂的知识用通俗易懂的例子，用最容易理解的话来表达出来。

博客里任何内容不要显得很突兀，博客总是要对外展示，去思考自己喜欢读什么样的文章，再去将这些文章里的优点搬到自己的博客里，避免那些缺点。

博客最忌讳什么？就是看完后没收获，让读者感到浪费时间！

而用通俗易懂的方式去表达复杂的知识技术点，不仅仅是对自己的提升，也让读者（面试官）感受到你深厚的功力，绝对圈粉！

• 图文并茂

谁也不喜欢看纯文字的博客，一定要加上图，当然图片一定要和文章相关，我这图片纯属是在致敬瑞克。

• 结构分明

上来先把一级、二级、三级标题列好，把目录做出来。

把博客当作论文一样去对待，有大纲，结构分明，让阅读者阅读起来很舒适。

• 可持续性

为啥大家喜欢看漫威电影？因为每部电影之间是连贯的，每部完结之后总会有新的电影去来持续把故事延续下去。

而博客也一样，要持续不断的写，从入门到实战，从零基础到精通。保证每年能稳定输出30篇以上的高质量博客，将博客作为一个系列去写，做到让任何一个看到你博客的人，想去看其他系列的文章，让你的博客就像永不断更的书，充满无限可能。

或者理解为，比如当你持续去写关于某一领域相关（比如软件测试相关）的技术博客，你终将成为这领域的技术real大牛！

三、写博客的选择方向？

其实任何题材都可以写一篇博客，计算机基础、网络、操作系统、编程语言、数据库、工具、业务流程等等，只要有价值的内容都可以写。

很多人总觉得博客是属于程序员专属或者技术大佬才能去写，这个想法纯属错误。

种一棵树的最好时机是十年前，其次是现在，开通技术博客同样如此。

没有说你什么都不会就开始去敲键盘去写博客，而是你要有一个明确要写的方向。

万事开头难，写技术博客也是，很多人会在起步这个阶段逗留很长的时间，在考虑要不要写技术博客，写什么样的题材，去哪里写博客，要不要搭建自己独立的博客等等，光是考虑这个问题就耽搁了很长的时间。就比如我这个账号，虽然16年就已经注册成功，但直到现在才真正的开始。

所以到底什么内容才能去写一篇博客？

小的方向可以是一个运行报错的解决办法，或者是软件的安装教程，也可以是读书后的读书笔记等。

大的方向可以是编程语言的基础和高级语法、框架等，可以是自己写的demo，面试遇到的问题总结，协议的学习等。

总而言之，只要是对你或对他人有用的，就可以写成一篇博客发表。

四、如何写好博客？

根据自己写博客的经验再结合网上一些资料，总结出以下答案：

• 写博客不是写流水账，要有明确的主题，内容结构分明

在写一篇博客之前，最重要的是先理清楚文章的思路和概要，写作过程中按照大纲的思路去执行。文章结构要清晰分明，根据大纲或者思路分为不同的段落，每个段落有重点描述内容。

• 把要写的问题或者知识点剖开，再用通俗的方式表达，思路为：背景 —— 排查 —— 解决 —— 防止

问题背景：如何发现的问题？在什么情况下发生的？造成了什么样的影响？

排查过程：针对展现出来的异常，需要做一些测试来验证，整个过程就需要不断的测试、研究、推断、验证。

解决方案：根据上一个步骤找到的问题本质，在这个步骤中去解决，总结有哪几种解决方式，最后采用了哪种解决方案。

问题防止：解决问题之后，总结经验教训，防止下次此问题再次发生，采用了哪种监控措施和应对措施。

• 再写新技术、知识点前，要去结合其他教材或视频，确保写在博客上内容的正确性与实现方法多样性

调研阶段：你遇到某一个新知识时，首先要对技术做调研，将研究的过程中写的相关demo放在博客中，方便自己深入理解。

背景描述：对于新技术、知识点首先描述一下背景，对比有那些类似技术，各有那些优势，为什么选择此技术？

环境介绍：此技术的依赖环境是什么？需要做哪些技术准备，可以将搭建环境的步骤写在博客里。

环境验证：搭建完成之后，用一个最简单的hello world验证环境是否搭建成功。

上手阶段：先写一两篇非常简单但可以突出其巨大优势的demo，让读者用以低成本来了解此技术的优势。

深入研究：需要对此技术进行进一步的研究，可以写一些解决特定问题的demo。

• 插入相应说明的图片，demo代码块，并配上相应的解释（注释）

插入对应图片，让博客整体可读性更高，用图片将内容更为生动形象的表述出来。

文中涉及到代码，尽量使用code的样式来展示。

代码只展示核心代码片段，在文章末尾给出完整代码地址，最好是github等地址方便大家关注。

• 简洁大方，将关键点关键字加粗上色，让博客整体突出重点

简洁大方颜值高的博客，会给读者如沐春风一样的感觉。

试想一下如果你看到这么一篇博客，有背景介绍、思路清新、文章排版整洁、又提供了完整的示例代码，你会想看吗？

写完一篇博客的时候，首先想想，如果你自己看到这篇博客自己会喜欢吗？如果自己都不喜欢，那肯定还有优化的空间。

• 博客抬头结尾最好加上属于自己特色的“标识语”，添加版权信息

笔者：风起怨江南 出处：杰克测评-CSDN博客 

笔者原创，文章欢迎转载，如果喜欢请点赞+关注，感谢支持！

统一标识，建议在各个平台、社交网站使用统一的ID、昵称、头像，方便读者记住你。

越是对知识点理解透彻，越是能写出对大家有用的博客，而理解透彻则需要阅读大量的书籍、资料、博客，去看底层实现。

初期写博客的时候可以给自己定一些计划，比如一周一篇。坚持一段时间后，会找到自己的感觉和节奏，再进行调整。

刚开始写博客的时候可能会想，写什么呢？有什么素材可以写？写的越多越会发现，其实生活中的一切都是素材。

比如想写一篇关于HTTP协议的博客，想彻底理解协议就必须去看对应相关的RFC官方文档等，再通过抓包的手段去扣每一个细节，看是否和官方文档里写的一致。

写博客的过程没有人能够帮到你，你只有自己不断删了再写，去尝试，去做，博客才会越写学好。

写作有时候是痛苦的，辛苦N天写的博客，感觉并没有完全表达出自己对某些技术的理解，很沮丧；写完博客后反复核查语义是否正确、是否有错别字，常常修改好多遍，往往把自己都读吐了。

五、博客的未来？

持续把写博客作为自己的习惯，不管怎么忙，一定要坚持下去。

很多人会说大道理我都懂，写博客的好处我都明白，但我真的没时间也没精力花费大块的时间去写博客。可学习路上，哪能松懈啊？技术日新月异，一年不进行充电，不进行提升自己，很容易被后浪替代。让写博客成为习惯，每天进步一点点。

博客的未来是什么？

• 沉淀、积累，让博客逐渐成为你在互联网上技术的简历
• 积累粉丝，让你的博客帮助到更多的人，拥有更多的人气
• 从博客到全网，不断地去扩充和发展，让博客最终发展为你展示技术的舞台

当然一切的一切，写好博客的核心都是需要你不断的学习积累并将其总结。

想成为行业大牛，想拿高薪，肯定不是嘴上说说就可以的，在任何一家招聘JD（工作描述）上都可以看到职责要求，每年都会新增有大量的要求：比如一个初中级测试人员必须要会一门编程语言，必须要懂自动化，要熟悉数据库，要熟悉Linux各种命令，要会性能或者安全测试等。

学习路上总是枯燥乏味，但为了生活总是要去改变自己的懒惰。

而坚持写博客，就是你改变的开始。

笔者：风起怨江南 出处：杰克测评-CSDN博客 笔者原创，文章欢迎转载，如果喜欢请点赞+关注，感谢支持！