上周有给一些小伙伴分享写文章的一些经验，本以为身为程序员的自己讲的内容却是写文章会有点水，没想到大家的反响还不错，因此这里我将这些内容分享出来，希望能对更多的人也有用处叭～

为什么要写

做一件事之前肯定都会有些原因，对我来说，开始写文章最初是由于自身的记性差。

(1) 记性差

前端是一个技术变化和更新迭代非常快的领域，因此我们需要不断地进行学习。

很多时候，学过的一些内容由于没有长期使用，很快又会忘记，也因此一些坑会反复掉进去很多遍。为了避免这样的情况，我用了最笨的方法：写下来。写下来之后就可以很方便地翻出来，也可以通过搜索引擎搜索到相应的内容。

(2) 思考是一件很有意思的事情

习惯写笔记之后，发现越来越多的东西可以写下来。写文章和拍照片、排视频不一样，我们每次动笔之前都需要思考并组织自己的语言。所有这些写下来的东西，再次翻阅的时候都会重新思考，你会发现自己的认知跟以前不大一样了，会不断更新自己的认知。

(3) 分享可以拓展视野

如果每个人都将自己的经验分享出来，大家会共同进步，越走越快。而当我们将自己的思考和想法分享出来，可以让更多人一起思考和研究，激起大家的讨论。

在交流的过程中，你会发现“原来他们是这样看待这个问题的呀”。通过这样的方式，我们可以接触到各种各样的思维方式和角度。

(4) 提升效率

我们在工作中，开发过很多系统，也踩过很多的坑。因此，有时候会有一些遇到同样问题的人来问，如果每次我们都要详细地跟对方讲解，会耗费不少的时间和经历。如果我们有养成记录的习惯，当对方询问的时候，可以直接把自己的笔记或者文章链接，直接给到对方阅读。通过这样的方式，可以节省双方的时间。

怎么写

一两年前我也做过写文章的相关分享，当时我并没有提出特别多的写作技巧。因为一直以来，我都没有关注该怎么去写，只是单纯地把自己想要记录的内容整理一下，然后记下来而已。

而当有些人问我，写文章到底有什么方法，刚开始我答不上来。后来我也观察自己写文章的一些思考方式和习惯，发现的确会有些注意的地方，在这里分享给大家。

文章的目的是什么

在写文章之前，我们首先需要理清这篇文章主要目的是什么。对于开发来说，一般可能包括：

• 某个问题的解决过程
• 对新知识/技术的理解
• 架构设计和解决方案
• 工具的使用经验
• ……

在理清文章的大致方向之后，我们可以整理出大概的思路，比如：

• 某个问题的解决过程 -> 问题描述、问题分析、解决过程、总结
• 对新知识/技术的理解 -> 技术介绍、应用场景、技术比对、自身思考
• 架构设计和解决方案 -> 背景介绍、现状问题、业界方案、方案设计、执行过程、执行效果、未来规划
• 工具的使用经验 -> 工具出现背景、设计原理、解决什么问题、工具说明、使用效果、踩坑记录

以上这些只是举例参考，我们在梳理出文章的大致思路之后，就很容易继续往下写了。

文章的目标对象是谁

在开始写文章之前，我们还需要知道文章是写给谁看的。

前面也说过，我记性比较差，即使是自己写过的文章过段时间也常常记不住了，所以经常需要自己再去翻阅。因此，对我来说，很多时候文章都是写给自己看的，同时这篇文章也可以写给和我遇到同样问题的人。

当我如果想把这篇文章给到其他人看的时候，要知道其他人的认知和我并不会完全一致，因此我需要在这篇文章里做一个认知差距的补充：

比如，我之前有写过一篇《响应式编程在前端领域的应用》，阅读这篇文章的人可能并不认识响应式编程，因此我会在文章最开始补充这块的知识：

确认文章大纲

前面我们在整理文章的目的的时候，已经大致梳理了文章的写作思路，在这里我们就可以梳理出大纲。比如这篇文章怎么写这段内容的大纲：

1
2
3
4
5
6
7
8
9

怎么写好一篇文章
- 这篇文章的目的是什么
  - 记录过程
  - 新技术介绍
  - 架构设计
  - 工具使用经验
- 文章的目标对象是谁
- 确定文章大纲
- 写文章技巧

列大纲也可以使用思维导图的方式整理，看个人习惯就好。

写文章技巧

在确认了文章的大纲之后，我们就可以往里面填充内容了。在具体写的时候，有几个小技巧：

(1) 多进行总结和概括

可以采用总分总、总分、分总这样的文章结构，要有文章概要或者总结的部分,比如：

• 文章的最开始，可以列出这篇文章大概会讲些什么内容，这样别人就可以一下子看出这篇文章里有没有他们想看的内容
• 在文章的最后，可以列一些未来的展望，或是这篇文章的总结、自身的感想等等作为结束
• 具体写作过程中，也可以阶段性地进行一些总结，同时还可以给这些内容加粗着重标志

(2) 避免一段文字太长

尽量让每个段落保持在不超过 4-6 行的长度。如果一段文字内容太多，别人在阅读的时候稍微不注意就会忘记自己看到哪，导致阅读体验下降。

(3) 适当地加入一些图片/图形

通过图形的方式，别人可以更加形象地理解我们想要表达的内容，比如架构图、时序图、逻辑图
等。

(4) 拆分步骤、分条列出

这个过程我们也需要对自己的表达进行结构化整理，同时其他人在阅读的时候可以很清晰地理解文章的内容。

如何坚持写

写文章其实不需要太多的技巧，写的过程中会慢慢地形成自身的习惯。

但写文章最难的点在于，如何坚持下去。在很多时候，写文章都会显得吃力不讨好，大家都不爱写。甚至像我这种经常写文章的，有时候会有人认为工作不饱和、种很闲没事做。那么，我们要怎么让自己坚持写文章呢？

量变到质变

不用着急一次性写好，写文章就像写代码，需要不断地改善和优化。或许刚开始写的时候，一篇文章要三四天甚至一两周，但如果写多了慢慢地就会写得很快了。

进入良性循环

尝试让写文章这件事进入良性循环。

知识沉淀，其实对工作是很有帮助的。我们在和其他人分享自己的经验时，也可以获得其他人的一些经验，从而拓展了自身的视野。而当我们把文章分享出去之后，也会慢慢不断地收到的一些反馈，在积累过程中也给自身搭建了不少的自信和热情。

让一件事变得更加有趣

文章收到反馈都不具备实时性，很可能我们在发出去之后，需要一周、一个月甚至一年之后才会收到反馈。因此，更多时候可以考虑如何将一件事变得更好玩。

写文章，和写前端有个共同的特点，所见即所得。这意味着我可以加很多自己喜欢、觉得好玩的事情进去，整个写的过程它是一个很有趣的过程。

可以尝试在工作里也这样做。比如，之前帮后台写一个内部管理系统，当接口返回 404 的时候，随机生成一个猫的图片。除此之外，我也常常在代码注释里写一些结合心情的内容和表情包。

在重新整理自己的博客为前端游乐场的时候，也加入了很多自己喜欢的猫：

通过这样的方式，可以把一些事情变得很有趣，也会更加喜欢上做这些事情，也可以更好地坚持下去。

结束语

我们工作的很大一部分内容，都是在反复踩别人的坑，研究别人的代码，而这部分的经验，都是可复制的。一个在某个领域、业务经验熟练的人，只需要把他的经验分享出来，就能快速让其他人获得这些经验。

这样做会让自己的不可替代性变弱吗？我觉得并不会，工作中基本上没有不可替代的人，但我节省下来的一些时间，可以做更多的事情，可以往各个方向拓展自己，也可以培养点兴趣爱好，甚至希望早点下班回家也都是可以的。

有些小伙伴会担心自己写不好，或者写出来后受到质疑，就不敢大胆地写，或者写了不敢大胆发出来。

在这里，分享自己很喜欢的一句话给大家：

“如果因为怕别人看到就不做自己觉得该做的事情，把它隐藏起来，那就等于说谁都不能做这个事情。如果自己把它做出来并让别人看到，那就等于说谁都可以这样做，然后很多人都会这样去做。”
—曼德拉

查看Github有更多内容噢：https://github.com/godbasin
更欢迎来被删的前端游乐场边撸猫边学前端噢

如果你想要关注日常生活中的我，欢迎关注“牧羊的猪”公众号噢