技术文章的核心是什么?谈谈我的思考

2,670 阅读5分钟

大家知道我文章更新频率比较高,所以评论区经常会看到“高产像 xx”的评论,看上去我写文章比较容易。

但其实最开始我写文章也半天憋不出来,只是后来我逐渐理清了写文章的思路,知道了写什么、怎么写。

今天就把我这段时间关于写文章的思考整理出来,希望能给大家一些启发。

写什么内容

首先,任何一门技术都有很多可以写的点,比如 React,可以写 jsx、setState、fiber、hooks 等,比如 Vue,可以写 template、reactivity 等。

然后它们之间也不是孤立的,是存在联系的,比如 jsx 与 template 都是描述视图的 DSL,setState 与 reactivity 是不同的变动检测机制。

如果再加入 Webpack 呢,那关联关系就更多了。

任何两个概念(不局限于技术)之间都可以有 A * B 种组合,这叫做笛卡尔积。

当你掌握的技术足够多,对技术之间的关联思考的足够多,那有 A * B * C * ... * N 种无限多的内容可以去写,永远不会有没内容可写的问题。

那为什么会感到没内容可写呢?

可能是你对某个技术掌握的不够深,或者是对之间的联系的思考不够多。这时候多输入多思考就好了,总会找到值得一写的点的。

怎么写

明确了写什么内容之后,怎么写呢?

想把一个东西讲明白,主要是从逻辑上理清楚。也就是涉及到哪些概念、概念之间的关系是什么、整体的流程是什么。

比如介绍一个技术问题解决的过程,要讲一下背景、有哪些问题、涉及到什么概念、用什么技术解决、流程是什么、解决之后的效果是怎样的,这样一个思路就是逻辑上清晰的。

当然概念之间的逻辑有很多,比如并列、包含、推导等等,这些逻辑学的东西看似抽象,其实无处不在。

我们经常听说写技术文章要按照总分总的结构,写简历要按照 Situation(场景)、Task(任务)、Action(行动)、Result(结果)的结构来写,这其实就是对一些逻辑的总结。

只要能从逻辑上把一个复杂的东西理清楚了,那么这篇文章就成功了一大半。

理清了逻辑之后怎么表达出来呢?代码?其实很多技术人写文章的误区就在这,认为只有上代码才能把逻辑讲清楚,其实靠读代码理清逻辑是很费力的一种方式,比它更好的方式有很多,比如图解、讲一个故事、做一个形象的比喻等。

这就像同一个故事,可以用小说的形式、电视剧、电影的形式、漫画的形式等来表现。

这就像 react 有很多 renderer,包括 react dom、react native 等。渲染逻辑是一样的,却可以渲染到不同的平台。

文章也是这样,同一个逻辑,可以用很多种方式来讲,讲清楚逻辑不一定非得上代码。很多写的好的文章都是综合利用了图解、讲故事、比喻等方式,虽然还是讲那个逻辑,但是生动易懂很多。

而且同一个逻辑针对的目标不同,语言风格也会不一样,比如同一个故事,如果是讲给小孩听,那要口语化一点,如果是正式场合,则语言要严谨正式一点。

此外,排版也是比较重要的一方面,通过合理的划分段落可以让逻辑表达的更清楚。

但不管用什么方式来描述,不管什么语言风格,写好文章的核心还是要先把逻辑理清楚,再把逻辑用各种方式表达清楚:把事物之间的多对多的网状关系,找一个入口变成树状,再安排好顺序,线性的表达出来。

标题、封面

标题是对文章内容的总结或者引导,还要在符合文章内容的基础上适当增加一些趣味性,让读者有点进来看的想法。千万不要标题和内容不符,也就是所谓的标题党,这样会增加读者阅读文章时的反感。虽然会有一些流量,但流量的质量很低。

封面也是一样,最好和文章相关,有条件的可以自己画,也可以用一些工具来生成,比如创客贴、搞定设计等,也可以是任意的图片。这个影响不大。

总结

任何一个概念都有很多可以写的点,然后概念和概念之间存在笛卡尔积的组合关系,所以,只要掌握的东西足够多,对这些东西之间的关系有足够多的思考,就不会有没内容可写的问题。

写技术文章核心是把逻辑理清楚,有哪些概念、概念之间有什么关系、流程是怎么样的,等等。表达这个逻辑的过程可以用多种形式:图解、讲故事、打比方等,不只是上代码才可以讲清楚。

此外,语言风格要根据读者来适当做调整,排版、标题、封面等也要符合文章所要表达的内容。

好的技术文章应该是逻辑清晰易读且浑然一体的。

这篇文章梳理了我对写文章的阶段性思考,其实这段时间成长挺大的,感谢大家的支持。希望以后能够多输出一些优质的文章。一起加油吧。