如何撰写出色的技术博客文章

写作是一项非常棒的技能。能够清晰地用文字进行沟通，将有助于你的职业发展和个人成长。从职业角度来说，因为你在组织中的职位越高，清晰的沟通就越重要。从个人角度来说，因为写作就是思考。

没错。这听起来可能有点违反直觉，因为你会认为作家应该在写作之前进行思考，但几乎所有作家都会告诉你，思考主要发生在写作过程中。很多人觉得写作困难，并非因为语法或拼写，而是因为它需要你过滤和整理大脑中杂乱的思绪，才能在纸上形成连贯的论点。

我认为，写作过程中遇到的困难主要在于对写作的错误期望以及缺乏正确的写作流程。本文将探讨这两个问题，并向你展示写作其实并不难。我将特别关注技术类博客文章，这类文章需要的写作方法与观点文章（或小说，两者完全不同）不同。

写作期望

如果有人说自己“不是作家”，通常意味着两件事：他们不是好作家，或者他们不喜欢写作。如果他们不喜欢写作，那主要是因为他们不擅长写作。

事实上，每个人都能写作。有些人比其他人写得更好，因为他们写得更久。但写作经验不足并不意味着你的文章对别人没有用处。对于阐明技术问题的技术博客文章尤其如此。

举个例子： X-Team 博客上一些流量最大的文章是由一些写作经验很少的开发人员撰写的。然而，他们却带来了流量，因为他们的文章解答了许多其他开发人员亟需解答的技术问题。

关于写作，还有一件事需要意识到：每个人都会遇到困难。人们很容易相信专业作家不会遇到困难，因为他们看到的只是最终成品。但可以肯定的是，他们经过了无数次尝试，才最终获得了如此完美的成果。他们也曾盯着空白的纸片许久，觉得自己的写作很糟糕，甚至一度想要放弃。

但他们没有。他们坚持不懈，克服了写作过程中遇到的所有障碍。我相信，这在一定程度上要归功于他们正确的写作过程。

写作过程

当我需要撰写技术文章时，这个写作流程对我来说很有效。如果没有这个流程，我永远也写不出来任何文章。虽然我鼓励你尝试不同的写作流程，但我认为接下来要解释的内容足够抽象，对你也有一定的帮助。

我们需要一个写作过程，因为写作不仅仅是写作。写一篇文章需要作者做很多不同的事情。有时候，我会查一下 REST（表述性状态转移）是什么意思。有时候，我会大声朗读一段话，看看它是否流畅。还有时候，我可能会在纠结某个句子里要不要加逗号。

或许颇具讽刺意味的是，我写文章的大部分时间都花在了写作以外的事情上。

第一步：研究

写作过程的第一步是我最喜欢的。我喜欢研究我所写的主题，因为我几乎总能学到新的东西，而且这会让实际写作变得更容易。当我没有做过大量研究时，我写文章时会比做过大量研究时更加焦虑。

即使你已经非常熟悉即将撰写的主题，我也建议你至少先做一些研究，哪怕只是为了仔细核实你将要提出的一些论点。这不仅能让你安心，还能让你学到一些让你的文章更有趣的东西。

研究步骤包含两个方面：扫描和挖掘。当我需要撰写一个我不太熟悉的主题时，我会进行研究，旨在发现我想要进一步了解的概念。我不会试图去深入理解它们，只是想找出以后需要进一步了解的内容。我把这个步骤称为扫描。

例如，在撰写Docker vs Kubernetes博客文章时，我确定了这些概念：Docker、Kubernetes、Docker Swarm、容器编排、虚拟机、容器、Kubernetes 清单、微服务等。

一旦确定了这些概念，我就会逐一研究，直到深入理解。这可能意味着与同事交流，阅读网上文章，有时甚至阅读书籍。这就是我所说的“挖掘”。在这个过程中，我会做大量的笔记，并在开始写作时大量参考。

第二步：写

现在是时候打开一张空白的纸，盯着它看一会儿了。诀窍在于让你的完美主义自我安静下来。你的开场白不必马上就精彩绝伦。你的论点也不必马上无懈可击。只要写下点什么就行了。

如果你开始有点吃力，那就坐在纸上写一会儿。你可能会忍不住拿起手机，或者浏览网页，或者做任何除了写作之外的事情。别这么做。只需看着纸，让你的思绪滚动，直到你写出一个足够好的第一句话。

就我个人而言，我喜欢一次性写完初稿。这是写作过程中最难的部分，我希望尽快完成。如果要花几个小时，那就这样吧。

我更喜欢这种方式，因为写作总是需要一些时间才能进入状态（这和编程流程没什么区别）。分多次写草稿效率很低，因为每次都需要重新回到状态。

第三步：编辑

初稿写完后，至少让它静置几个小时，最好是一整天或更长时间。然后，像第一次阅读一样，再次审阅文章。这一步也分为两个部分：整体编辑和细节编辑。

我会先从整体编辑开始。我会阅读文章，思考可能需要做哪些结构性修改。我的整体论点合理吗？每个论点都合理吗？我需要调整段落吗？还有什么地方需要进一步研究吗？

接下来是细粒度编辑，我会仔细查看每个句子和单词。我能用更好的方式表达吗？我需要在这两个段落之间添加连接词吗？我怎样才能避免重复这个词？我应该在这里加一个逗号吗？这步是在整体编辑之后进行的，因为当你仍然需要对文章进行结构性修改时，查看这些细节是没有意义的。

这也是我努力想出最佳标题的时候。到目前为止，我一直使用占位符标题。占位符标题很少成为最终的标题。我通常会写十个或更多不同的标题，然后才最终确定一个。

标题极其重要，特别是在技术博客文章中，应该告诉人们可以从您的文章中期待什么。

这就是整个过程。调研（扫描和挖掘）、写作、编辑（整体且细致地）。我希望这至少能让你的写作变得更容易一些。如果你有不同的写作流程，欢迎在评论区分享👇。