如何写出别人看得懂的技术文章？

说起写博客，我从 2014 年毕业开始就有写博客的习惯，只不过当时写的博文更多是像记笔记，读者看下来迷迷糊糊的。我开始真正意义上的写博客应该是从 2017 年 8 月 23 日开始。在这一天我发表了我的第一篇博文：《图灵机快速入门教程》，讲的是图灵机的基本原理，以及科学家如何利用图灵机建造起计算机的大厦。或许因为文章写得还不错，所以首日阅读量不再是个位数。从那时候开始，我便保持一周一更的频率。虽然中间有过间断，但还是坚持下来了。

到了现在，我写作的时间将近一年了。通过这一年在博客园的坚持写作，我也取得了一些小小的成绩。2017 年 7 月份写的一篇《浅谈重构过程中踩过的坑》被博客园官方推荐，截止至今，斩获了 102 个赞，收获了 1 万多的阅读。前阵子写的一篇《藏在正则表达式里的陷阱》在时隔 7 个月之后再次获得博客园官方推荐，在 72 小时内斩获了 72 个赞，收获了 4000 的阅读量。除此之外，我写的《两道面试题，带你解析Java类加载机制》、《面对海量请求，缓存设计还应该考虑哪些问题？》、《从抖音关闭评论，看服务治理的重要性》等文章屡次进入博客园 48 小时排行榜、首页最多推荐、首页最多评论栏目，阅读量均在一天之内突破 1000。

在这一年的写作时间里，我也迷茫过、困惑过，也好几次被「下架」过，但还好坚持写下来了。除了写作，我也一遍思考博客园的运营思路，希望能与平台实现互惠共赢。从一开始的个位数阅读量，到后来稳定到几百的阅读量，到最终能稳定进入首页的流量池曝光。经过了一段时间的验证，我觉得我对博客园运营的一些思路得到了有效的验证，所以在这里分享我的一些经验给那些想写好文章的朋友。

写作的价值在哪里？

其实对于写技巧类的东西，我往往心有余悸，稍微不慎就会变成人人喊打的标题党。所以在开始正文之前，我想问大家一个问题：为什么写作？

对于我来说，我收获的是技术交流以及技术实力的提升。

通过写技术文章，我把之前看似掌握的知识再次深入研究，再次加深了对知识的理解。而当文章发表之后，看你文章的人又会提出各种疑问，这些疑问又促使你去思考。有好多次我以为自己对某个技术的理解是正确的，但当读者提出疑问时，我才意识到自己理解错了。所以对于作者的我，写作的价值是技术实力的提升。

那对于读者呢，他们收获了什么，这是一个很重要的问题。如果你的文章无法给读者带来价值，那么读者久而久之便会远离你。只有你的文章对读者是有价值的，读者才愿意阅读你的文章，也才愿意给你更多的反馈，作为作者的你也才会更有动力去写作。

对于读者来说，读者收获的是深入浅出的技术见解。

通过阅读我的文章，读者能够通过我简单的语言，理解了之前无法理解的技术，学到了更多的东西，提升了自我。知识的提升本身就是一件很有价值的东西，你创造了这篇文章，这篇文章又影响了无数的人，让无数人获得了知识。获得知识本身，就是一种价值。

应该写什么样的文章？

前面说过要写对读者有价值的文章，那究竟什么才是对读者有价值的呢？

在不同平台上，这个答案可能有所不同。在微信公众号上，对于用户来说，能给他读者带来思考上的启迪，或许这就是一篇好的文章。而在博客园这种专业技术社区，或许技术类的文章才是「有价值」的文章。之所以会有这种区别，就是不同社区的定位导致的。

对于微信公众号这个平台来说，读者人群比较广泛，而且对写作题材没有做过于严格的限制，所以你可以比较自由地发挥自己的写作实力。但在博客园这样的社区来说，其定位就是一个技术类型的社区。这样的定位导致了它绝大多数的文章必须是技术性很强的文章，否则就合它的定位相悖了。

所以在博客园上，适合写技术类文章，而不是其他。

既然决定写技术类文章了，那技术类文章应该如何写呢？许多人写的博客其实都不算博客，最多就是自己的学习笔记，这样的文章对于读者来说基本上没什么意义。甚至对于作者来说，可能过几个月后再来看，他自己也看不懂了。因此写技术类文章，最重要的就是要让读者看懂，要让读者明白你要表达的意思。只有当读者明白你的意思之后，你的文章才能给读者创造价值。

那问题来了，如何写出读者看得懂的文章？

其实这个问题很简单，但又一点都不简单。它简单之处在于，如果你是一个同理心很强的人，这个问题就很简单。如果你缺乏同理心，即不懂得站在读者的角度思考问题，那么这个问题就很难。可能上面说得很玄乎，但没关系，我说得简单一点，同理心其实就是把你自己当成是读者，问问自己：这文章你能看得懂吗？懂得站在读者的角度看文章是非常重要的，只有学会了这个方法，你才知道自己的文章写得好不好。

上面说的说的都是理论的部分，下面说说实践的部分。

要写出读者看得懂的文章，可以采用故事式的写作方式。所谓故事式的写作方式就是交待好故事的背景，之后再一步步深入探讨问题，最后给出问题的解决方案。带着读者一起深入到问题中去，带着读者一起思考，最后再把读者带出来，就像做一个全包的旅游保姆一样。千万不要带到一半突然跑路了，这时候读者是会很愤怒的。

我举一个例子，我在写《藏在正则表达式里的陷阱》之时，首先我交待了这个「陷阱」的背景（机器100%CPU异常），之后简略交待了如何定位问题（Dump出线程信息），最后针对回溯问题做由浅到深的深入讲解。对于这类问题，最重要的还是把问题背景交待清楚，如果读者连问题都不清楚，那么你后面的分析就完全没有意义。

对于不同类型的技术文章，叙述方式会略有不同，但理论的部分却是一致的。时刻站在读者的角度上思考问题，想想读者能不能看懂，这是最重要的事情。

说了这么多，其实都是纸上谈兵，要真正获得写作技能的提升，还是需要开始写起来，只有开始了才有进步的可能。对于刚刚开始的朋友，我建议你可以从模仿开始。看看那些写得好的文章，它们为什么写得好，去分析、去思考，最后模仿它们的写作方式。在模仿过程中，你会收获很多东西，与此同时你的写作技能也在不断提升。

应该如何运营？

文章写出来了，应该如何让更多读者看到你的文章，这是一个很现实的问题。如果你写的文章一直没人看，阅读量都是个位数，没人点赞、没人评论，我相信你也写不了多久。而要提升阅读量，就必须说到运营这件事情，这个很技巧性的东西。

要提升阅读量，你首先需要了解这个社区的流量来源。对于博客园来说，其流量来源非常单一，就是首页的七处地方，它们分别是：首页信息流、编辑推荐、最多推荐、最多评论、48小时阅读排行、10天推荐排行、编辑推荐排行。

• 首页信息流

首页信息流是我们日常浏览文章的主要区域，但其时效性比较高，随着时间的流逝，你的文章会淹没在文章流中。

对于广大的作者来说，首页信息流是一个日常的、成本最低的获取流量入口。只要你的文章是原创技术文章，并且达到了一定的篇幅，那么在发表文章的时候勾选「发布至博客园首页」按钮，那么文章就会出现在首页信息流中。

而发布文章最好的时机是在工作日的早晨8点-10点之间，这个时间刚好人都准备上班，上班之前都会稍微浏览一下技术文章。只要你的文章标题起得好，内容也不错，那么文章收获几百的阅读量是非常轻松的。

• 编辑推荐、最多推荐、最多评论

这三个位置是流量的第一大入口，其中「编辑推荐」是官方选定的，而「最多推荐」和「最多评论」则是动态调整的。

因为「编辑推荐」是人工选定的，其不确定性较高，所以很多时候我们能努力的就是「最多推荐」和「最多评论」这两个位置。所以如果你想你的文章让更多人看到，那么你就必须要争取到「最多评论」、「最多推荐」这两个位置。而争取到这两个位置的唯一办法，就是提高文章质量。只有你的文章是高质量的，能引起读者共鸣，那么评论和推荐数就不会少。

• 48小时阅读排行、10天推荐排行、编辑推荐。

这三个栏目与「最多推荐」和「最多评论」一样，都是动态调整的。这三个栏目的位置大多在第二屏的右侧，流量相对于「最多推荐」会少一些，但也是一个主要的流量来源。

在这三个栏目中，我们能努力的就是「48小时阅读排行」和「10天推荐排行」。至于如何登上榜单，就得靠你的文字功底和技术实力了。

对于广大作者来说，我们要力保「首页信息流」带来稳定流量。在这基础上，争取「最多评论」、「最多推荐」、「48小时排行版」的位置。当你的文章质量达到一定程度时，或许天使之手就会带你上「编辑推荐」了。

什么才是最最重要的？

对于刚刚写作的朋友来说，其实最重要的不是文章质量有多高，又或者运营技巧有多好，最重要的还是能长久地坚持去写东西。要想长久地坚持做一件事情，那就必须形成正向反馈，最终形成良性循环。作者与读者的关系更是如此！

作为作者，你要思考什么样的文章能给用户带来价值。而作为读者，对给你带来收获的文章进行推荐、评论和转发，是对作者最好的鼓舞。通过这样的一个循环，作者收获了继续创作的动力，而读者又获得了知识技能的提升。这是一个非常理想的互惠共赢的状态。

所以在这里，我更多地呼吁大家更多地参与到文章的讨论中去，而不是看完了就走。如果一篇文章给你带来收获了，那么请不要吝啬你的推荐和评论，把你的收获传递给作者。

虽然我也知道我的呼吁不一定有用，甚至会引来许多人的嘲讽，但我还是希望自己能为不为利益去做点什么东西，即使这份力量很薄弱，但这也是一份支持。

树义有话说

对于许多技术朋友来说，很多人都喜欢用 Google，而不喜欢用百度。当问起为什么的时候，很多人都把原因归咎于百度的搜索算法不好，搜不出想要的东西。但实际上真的是这样吗？

我并没有时间和精力去深入研讨百度的搜索算法，但按我的经验来说，很多人不愿意用百度搜索的原因是：搜索出来的文章都是一篇文章抄来抄去。所以说，这到底归根于谁？恐怕作为技术工作者的我们，每个人都难辞其咎。

作为技术写作者的我，其实特别想去改变这个现象，但很多时候又觉得自己实力不够。但通过这一年的写作和反馈，我觉得自己可以尝试着去做这么一件事情了。虽然我也不算是几千粉丝的大V，但对于这件事情来说，重要的不是你有多大影响力，而是你到底有多想做这件事情。无论你是刚刚还在大学念书的学生，还是已经工作一段时间的码农朋友，只要你希望通过写作来分享自己的技术见解，我都欢迎你与我一起交流。我在时间允许的情况下，可以对你写的文章给出一些建议。

因此我建了一个群，让大家交流技术写作的心得，我也会在群里分享我的一些经验。希望更多的人把自己的技术分享出来，而不仅只是转载或笔记。

如果你想加入，请加我的微信（ID：Spark-tree），我拉你入群。备注写「来自博客园，加入技术写作交流群」。

最后希望大家能写出更棒的文章，在写作之路越走越好！ : )

看了这么久，去右下角点个推荐再走呗。