技术工程师：撰写流畅的技术部落格 六大写作建议干货经验

近年来，不管是菜鸟还是资深开发者都流行写技术部落格，分享自己的学习足迹。为了帮助学生摆脱被动学习的习惯、让自己的所学更加扎实，ALPHA Camp 在全端网络开发实战营开课前，就开始鼓励学生撰写部落格。

对开发者而言，写技术部落格好处多多，对学习、求职、建立个人品牌都有正面助益。我们的学生们也写出了心得，享受边学边写、边写边学的乐趣。

但对于许多自学程式的学习者心中，写技术部落格如同苦差事，他们心里想着：

学程式已经很辛苦了，还要花时间写部落格？

从高中毕业后就再也没写过作文了，不知道怎么写出一篇通顺的文章。我还在学习中，给大家看到我的文章会不会让人觉得班门弄斧？如果被发现有错误不就很丢脸？我写的这是什么东西...

这些心理障碍都很正常。因此，我们将在本文分享如何破除心理障碍、并详细说明「写部落格的六步骤」，只要跟着做，将能显著减少写部落格时遇到卡住、离题、鬼打墙，建立信心和成就感。

一、写技术部落格的好处

让学习更扎实心理学研究显示：「最有效的学习方式，就是教别人。」自己将知识消化、吸收，然后教导其他人，学习成效更胜于考试。写部落格就如同教学，需要有完整的逻辑和论述，一方面让别人能够看得懂，另一方面让自己的学习更加扎实、更有成就感。

写部落格是一个从被动学习转为主动学习的过程。写作的过程中，需要搜寻资料、找出重点、消化统整资讯，除了帮助自己建立深刻记忆，也可以大幅减少将来需要时，花在复习、唤起记忆的时间。

刚开始写部落格，不用要求每一篇都要有独特的个人见解，可以从最简单的「笔记」形式开始，以自己刚学到的内容为出发点，在网络上多找一些补充资料，把一些概念的定义与关键字整理出来。光是这个动作，就能加深你对这些概念的印象。慢慢的，你就会能够有效的分享你的学习过程与领悟，并把概念内化，说明给你的读者。

提升软实力写作除了为自己写之外，当然也是希望与世界沟通。写作的过程中，你需要把一些相对抽象、技术性高的概念，用他人可以听得懂的语言，写成有条理的文章。这个过程能帮助你锻炼出沟通表达能力。网络开发是一个很讲究团队合作的专业。良好的沟通表达能力是你提升为更优秀的开发者的重要一环。

有助于求职尤其对于非资工背景的开发者而言，写部落格可以帮助雇主们了解「你懂什么」与「你能沟通吗？」这两个核心的技能。雇主除了看你的作品和面试表现，他们能经由你的部落格，看见你学了哪些技能、你是如何思考的、以及你的沟通能力。

相较于在自传里写自己多积极、多有学习热忱，不如一篇篇扎实的技术部落格，更能展现你的成长潜力。

帮助他人、提高影响力用心写的内容，一定会被需要的读者看见，你的部落格也将会持续帮助其他的开发者、学生，偶尔有大神路过也会指点一二。

持续提供价值的开发者是受到社群欢迎的，而部落格就是你提供贡献的媒介，其他的例如个人品牌、工作邀约、拓展人脉等，都是随之而来的附加价值。

写部落格有那么多好处，但很多人还是无法踏出第一步，或是好不容易开始了却又三分钟热度。以下说明如何破除心魔。（第2大点）

二、写部落格前先破除你的心魔

我还那么菜，要写什么？写部落格不是「大神」的专利。正因为你不是大神，所以你可以用凡人的角度、用凡人听得懂的语言，分享你的知识和心得。身为开发者，每天都会有机会学到新东西。无论是菜鸟还是老手，刚学到新技能时记忆犹新，最适合记录下来，帮自己复习，也分享给其他人。

我的文笔不好技术部落格的重点不是文采，而是要清楚地表达你的观念和想法。而所谓文笔不好更深层的原因在于：观念不清楚和逻辑不通达。

观念不清楚可以靠大量阅读、多写程式磨练，逻辑不通达则需要多读、多写，练习如何整理自己的思绪，改善沟通表达技巧。但重点是：不开始写，文笔永远不会变好。只要一开始写，你就有进步的机会，也会逐渐写出心得和兴趣。

我没有时间有两个原因造成「没时间」写部落格：缺乏动机以及时间管理问题。以下三个方法摆脱借口：

给自己设定合理的目标，例如目标每两周写一篇、长短不拘养成规律习惯，防止「拖延症」上身。例如固定安排每周日早上4 小时专心写作把写作培养成习惯和兴趣，而非被逼着写、或是为了利益而写

我不知道如何开始好不容易下定决心，坐在电脑前却文思枯竭、难以下笔，才发现自己的「手感」已经生锈了吗？

手感生锈没关系，给它上油就行了。刚开始写部落格时不要太贪心，可以从短篇的的学习笔记开始建立信心。

接下来，我们将分享「写作的六步骤」，帮助你成功找回手感，顺畅地完成第一篇文章。

开始动手写！以下是撰写一篇技术部落格的流程。无论你要写长篇、完整的文章，还是短篇的小笔记，这个流程可以帮助你聚焦，写出一篇逻辑通顺的文章。

1、选择题材

技术部落格的题材，大致上可分为以下七个类别：

介绍自己的作品适合在学习过程中地记下自己容易混淆的观念。以解释观念为主，程式码为举例和辅助说明，实作的部分较少。实作教学的目的，是详细纪录做出一个功能的过程，文中会详尽地说明技术观念、操作步骤并附上程式码，让读者可以跟着做。演算法解题分享（LeetCode 1. Two Sum）分享自己喜欢的的连接和学习资源。阅读心得、参加活动和演讲的心得刚开始写部落格，可以从简短的「观念笔记」和「资源分享」开始，为自己的手感暖身。建立起信心后，撰写长篇的「实作教学」会更加有把握。

部落格的题材除了从自己学程式的过程出发，也可以浏览Quora、Stack Overflow 等问答区，从他人的提问中找灵感。

2、搜集资料、脑力激荡

选定要写的主题之后，就可以开始搜集资料。可以从自己正在学的主题出发，向外延伸找补充资料，Quora、Stack Overflow、技术部落格、和其他开发者请益，甚至GitHub 上的技术文件都是你可以参考的对象。

要注意的是，在这个阶段，你搜集资料的目的只是「脑力激荡」、并帮助你列出文章大纲，而不是要写出完整的文章。因此，一开始不要找一大堆资料、开一堆视窗，让自己的思绪混乱又挫折，反而迷失方向。

以撰写本文为例，一开始只看了五篇文章，虽然不多，但足以列出文章大纲。一边读参考资料的过程中，也一边简单纪录自己可以用的重点，例如：为什么要写部落格、如何坚持下去、写部落格会遇到的心理障碍...。过程中如果想到其他ideas，也一起记下来。

3、列出段落大纲

就像画图前要先构图，写文章前先列出段落大纲，可以帮助你整理这篇文章的脉络、检视逻辑是否通顺。大纲规划得越清楚，就不会写到一半时才发现自己在鬼打墙。

写段落大纲不难，只需要把刚刚找资料时纪录的重点，以自己的逻辑排序，并删除不必要的部分。一开始的段落大纲不用很详细，只需用简短的句子和关键字，帮助自己整理这篇文章的架构。如下图：

如上图所示，把这篇文章分成三大段落，分别是「为什么要写部落格」、「写部落格前要破除的心魔」、「写部落格的步骤」，每个大段落中再用简单的关键字，纪录该段落会包含的内容。拟定了文章的大概架构后，接下来开始做更细部的规划。以上图的第三段落「写部落格的步骤」为例，我们来规划更细部的大纲。如下图所示：

注意到了吗？原本的大纲只有「题材」、「找资料」等简短的关键字，现在我们加入了更多详细的论点，让这个段落的轮廓更加清晰。

规划段落大纲要到多详细？这没有一定的答案，以自己方便为主。但可以肯定的是，规划得越清楚，之后写文章一定会越轻松。段落大纲就是给自己的备忘录，规划大纲的过程中可以同时搜寻资料，把外部资料连接放在某段落的下面，让自己写到那个段落时不用再重新查一遍，节省时间。

4、撰写文章段落

拟定大纲后，接下来开始撰写文章段落。大原则是：最有把握的内容先写、文章开头与结尾可以最后写。

先写最有把握的段落，就像是为你的手感做暖身，帮助自己进入状况。没有把握的段落可以先放着，待搜寻更多资料后再来处理。

写技术部落格时，写到一半会卡住通常就两个原因：一、观念不清楚；二、不知道要写什么。如果观念不清楚，就针对自己混淆的地方，阅读更多资料找出答案。如果不知道要写什么，就回过头将段落大纲规划得更详细，重新调整文章逻辑。

为什么文章的开头建议最后写？因为当你对这篇文章的轮廓还很模糊时，撰写开头会很辛苦。等到文章完成了八九成，概念都融会贯通了，写出精准、有力的开头和结尾会非常顺畅。

对于教学文或技术分享而言，建议一篇文章的开头就要写明这篇文章的「目的和主旨」，让读者一开始就知道读这篇文章可以得到什么收获。文章的结尾，可以简单总结本篇文章的重点，帮助读者再次复习，并邀请读者留言提问和指教。

5、检查、编辑

终于写完了！但请注意，这时你完成的还只是「草稿」，先别急着发布出去。

如同写程式，写完文章一定要仔细检查，检查错字、赘字、专有名词大小写，并把句子修得更通顺。如果对自己的写作能力没那么有把握，可以把草稿传给同领域的朋友，确认他们也可以看得懂。

。文章发布在部落格上之后，记得再用电脑、手机检查排版有没有跑掉。很多时候，即使文章在电脑上的呈现很ok，但在手机上看才发现段落太长，一大堆字挤在一起密密麻麻、或是code 截图中的字太小看不清楚，这时就要再回过头调整。

6、分享出去

发布之后，除了在自己的脸书分享，也可以分享在和文章主题相关的开发者社群中（例如：

想让更多人点阅你的文章，除了把链接分享在社群网站上，也别忘了加上一小段文案，介绍这篇文章的重点，吸引对这个主题有兴趣的读者，并且有礼貌地恳请大家提供回馈。

了解了写部落格的好处以及写作秘诀，只剩下付诸行动啰！期待大家能早日体验到边学边写、边写边学的乐趣。

- end -