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

# 为什么要写

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

# (1) 记性差

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

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

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

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

# (3) 分享可以拓展视野

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

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

# (4) 提升效率

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

# 怎么写

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

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

# 文章的目的是什么

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

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

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

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

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

# 文章的目标对象是谁

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

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

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

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

# 确认文章大纲

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

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

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

# 写文章技巧

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

# (1) 多进行总结和概括

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

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

# (2) 避免一段文字太长

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

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

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

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

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

# 如何坚持写

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

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

# 量变到质变

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

# 进入良性循环

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

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

# 让一件事变得更加有趣

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

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

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

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

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

# 结束语

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

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

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

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

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

部分文章中使用了一些网站的截图,如果涉及侵权,请告诉我删一下谢谢~
温馨提示喵