【饭谈】为什么有的技术博文你看不懂?

668 阅读5分钟

「这是我参与2022首次更文挑战的第22天,活动详情查看:2022首次更文挑战」。

引子

读者们是否有这些疑惑?

有时候网上的很多技术博文和教程自己看不懂。反而有时候别人给你写一个非常简单的用a,b,c,d命名的demo出来你就瞬间清晰?

有时候同样一个技术点,绝大部分文章自己都看的迷糊,但是突然有一篇小白文自己就看懂了?并且能成功运用?

有时候周围的大佬们都看懂了,就自己看不懂,愤愤不平的你觉得这一定是个皇帝的新衣的故事。但是事后却发现真的只有自己菜?

如果有这种情况,请继续阅读...

正文

今天本人在网上学习一些大牛的技术文章,看完后津津有味。本着习惯看了看下面评论,这一看当场傻眼....

我以为大家会疯狂夸赞,结果....

图片

图片

图片

图片

几乎9成都在喷!

我一开始觉得很诧异,明明我看的很明白,我都忍不住要夸一句,为什么下面这么多人在喷呢?

我尝试把思绪切换到几年前的小白时期,我貌似也曾经看不懂很多博客文章。

但是为什么我现在看的懂了呢?明明这个上面说的知识点我是第一次见到啊....

想了一会,我知道了原因。

原因

看不懂 和 看的懂 的唯一区别,在于博文中技术之外的 基础辅助知识掌握的多少,并不在于博文中的技术本身是否是新的。

我举一个例子:

有人给你讲django平台怎么去写接口:

那个博主是一个这方面非常专业的前辈,所以他写出来的东西,往往掺杂太多经验和其他知识点。往往会带着比如:restful风格和命名上的规范,这中间跨度太大,所以读者需要先去了解什么是restful才能看的懂博主为什么要这么写路由,为什么要这么设计。然后想了解restful又要去了解rest风格架构,然后要去学习传统路由和rest风格路由的区别,然后还要学习所有错误码(200-500)的含义,然后要理解数据库表的设计和url之间的联系,要明白什么是url自带说明性,了解post,put,delete,get的作用和区别还有适用场景,甚至还要学习如何对一个表资源的增删改查操作进行封装,甚至还会了解到put和孪生兄弟patch有什么区别,还有这些类名,怎么全是相似的一大串不认识的英文单词,还有数据库命名的规范,数据库里一大堆看不懂的函数,然后最后想实际操作还要下载部署配置restfarmwork,弄了半天也没搞定...

要知道,知识之间都是有联系的,这第一个接口你还没有真正下手去写,就先发现学的东西似乎没有尽头,但是不学你又看不懂博主为什么要这么写一个接口,胡乱跟着抄完不但全是报错,也没有任何意义。

最后,辛苦忙活了很久之后,你发现你毫无进展。区区一个接口自己都看不懂怎么做,整个平台要怎么搭建,简直笑话。所以很多人到这时候就会觉得自己笨,底子差,就放弃了测开。

我是怎么做的

后来我开始写文章的时候,就会注意这个问题,我讲一个技术,就是一个技术本身,尽量不掺杂其他的知识点。什么restful的,读者还没学过这个东西,我为什么要按照这种风格呢?传统风格一眼就会。等读者写完了这个接口,我再讲restful风格,让他在这个基础上进行优化进化,不是更好么?

毕竟知识要一步一步来,步子迈大了,肯定要扯蛋。

但是其他一些博主的文章仍然我行我素,当然我理解,因为真的降低了自身水准去用很土的办法写技术,一定会被喜欢装x的其他博主笑话,甚至会让外界认为自己非常菜啥都不会就来写博客了。

但是!能让别人看懂才是最重要的!这就是写文的技巧,教书育人的技术。并不是严谨的科学探讨会!

如果你写的是论文,那么你想怎么专业怎么专业,想怎么秀怎么秀都行,没人拦着你,因为看的都是同行专家。

但是你既然选择写博客,面向大众,就要放低门槛,用小白能听懂的土话来讲,这样你能讲明白的话,你才是大神,超脱那些其他博主专家一个境界的大神。

就像一个小学数学老师,他在给小学生讲课的时候,绝对不会扯到什么方程式,什么函数。

就像我刚学代码时,教授没有给我上来就规定死一堆的标准风格,而是赞同我们用最简单的a,b,c,d来当做变量。

所以学习最好的办法是有着重点,有先后,有主次。不是说必须要教程的第一节课就一股脑的把自己目前最高的水准展现出来,那样只会让读者望而生畏,产生和你的距离感。

思考到这层之后的我,写的东西大多人都能看懂,知识没有牵扯太杂。