本来我这篇文章的标题是 “如何撰写受欢迎的技术文章”,但反复斟酌之下,还是加了一个“较”字,这主要是考虑我不是什么知名作者,写的文章大多也谈不上很受欢迎,贸然地谈“受欢迎” 是有点忐忑的,而改成现在这样,虽然只是一字之差,但就多了一份进退的空间,自信心也就油然而生了。
我写技术文章的时间,算起来有超过13年了,我一直在国内比较早期的技术博客平台——博客园发表文章,至今已经有 1347篇随笔,累计阅读量约 96万,拥有“推荐博客”的荣誉。根据博客园的规则,我目前排名第40位(以前可能还略微靠前一些),跟很多大家耳熟能详的大牛相比,我还有很大的差距。
我的技术博客地址是 https://chenxizhang.cnblogs.com
我写的文章在数量上有一定的优势,这可能跟我写的内容和方式有关系。熟悉我的朋友大抵知道,我有相当长一段时间做咨询顾问和培训讲师,那段青葱岁月,相对单纯的日子,每天的日常就是吃饭、睡觉、写文章(或做案例)。做培训讲师需要不断地学习,而且通过把一些技术经验写出来,也是一种提高自我的方式。逐渐地,我的博客拥有固定的一批读者,他们给了我很多反馈、以及鼓励,和温暖。
那么,回到今天文章的主题 —— 如何撰写较受欢迎的技术文章?我想先用一篇目前为止在我的博客中最受欢迎的一篇文章作为例子讲解一下。
该文章的访问地址是https://www.cnblogs.com/chenxizhang/archive/2011/09/10/2172994.html ,你也可以在本文的底部,通过“阅读原文”链接访问。
这篇文章 《你得学会并且学得会的Socket编程基础知识》发表于2011年,算起来也有快8年的时间了,累计阅读量为75441,评论数为110,点赞数为 73,这三个指标都是各自领域的第一名。更加让我印象深刻的是,直到现在还仍然经常会有读者给我留言,有的还是专门为了留言注册了一个博客园账号,感动之余,我也在想其中的原因。
我们先来看看题材。写作有一个作用是帮助自己梳理思路沉淀经验,但文章主要还是写给别人看的,尤其你要公开发表的话。那么,“决定写什么” 是一个很重要的问题。你至少需要考虑
我的目标受众是哪些人群?这个人群有多大?
他们需要什么哪方面的内容?
思考这两个问题,看起来有点像做市场分析,大家可能会觉得不是技术人员的专长,但越来越多的经验证明这是很有必要的,其实这两个问题的背后还有一个深层次的问题:你是成为怎样的一个作者?你的目标是什么?
其实写别的文章,做别的事情也有类似的原则
这个题材 ——”Socket编程的基础知识“ ,老实说我在写作的开始并不太知道会有这么大的需求。我记得当时已经有多种技术可以做客户端和服务器端的通讯,尤其是要有状态的通讯。用现在的眼光来看,是不是因为这种偏后端的技术相对来说稳定(不像前端技术那样日新月异),有固定的用户群体,Socket是其中一种比较基础的技术,所以在这么多年还有人在不断关注呢?
我感觉,正如文章标题《你得学会并且学得会的Socket编程基础知识》所提出的那样,这篇文章胜在”情境引导“,有情境,所以言之有物,不是说空话套话,而引导式的目的是为了让读者能真正学会。该文章是通过一个完整的案例,并且是层层推进的方式给读者呈现他需要掌握的知识,而且连什么情况下会出现什么错误提示,都考虑到了。
同样的例子,还有常年霸占博客园推荐排行榜第一名的蒋老师的文章,例如这一篇 《200行代码,7个对象——让你了解ASP.NET Core框架的本质》https://www.cnblogs.com/artech/p/inside-asp-net-core-framework.html, 机缘巧合我还有幸听过他针对这个话题的现场演讲,这种抽丝剥茧,层层深入的方式,能时刻抓住观众(或读者)的注意力,而背后的原理和知识点,也是通过一个一个例子,润物细无声地传递给了他们。
另外一种写作形式,是系列文章。早些年博客园的鼎盛时期,真的是百花齐放,各路大神都有各自的系列,我印象深刻的有赵劫,Terry,蒋金楠,张善友等。写作系列文章需要足够的功力,这些能写系列文章的牛人,也大多成为了后面的畅销书作者。
还有一种我认为比较好的写作方式或者风格,就是有独立的见解,这是可遇不可求的。这方面,我一直很喜欢阮一峰的技术文章,如果我没有记错的话,他应该曾经做过大学老师,现在供职于阿里支付宝(Alipay.com),作为Node/Javascript的工程师。
同样讲一个技术话题,他的文章可以让你有不一样的收获。这主要取决于他对于这个话题的深入研究,旁征博引,并且有自己的一套独立的见解,而不是人云亦云。例如 《找回密码的功能设计》 http://www.ruanyifeng.com/blog/2019/02/password.html
阮一峰是70后,他的文章如此好,可能跟他的文化功底和社会阅历有直接关系,事实上他不光写技术文章,还写了几本文集呢。
工欲善其事必先利其器,在信息过载的时代,平台和工具的重要性还是不言而喻的。在选择平台到时候,你需要考虑平台用户群体是不是跟你的目标受众匹配,还要看这个平台未来的发展规划。这里特别要提到,如果你的目标受众是年轻一代,需要特别注意他们的学习方式、关注的平台是跟以往不一样的。
搞清楚了上面这个问题,对于作者来说,你选择的平台还要满足几个条件:
是否方便你的写作?是用客户端还是在线的?
搜索引擎友好性怎么样?这方面博客园做得非常好。
移动化阅读体验如何?
我在这篇文章中 (我分享给大家的个人写作经验) 有对写作平台的详细说明,有兴趣请仔细阅读参考。
说了这么多,也讲了很多技法,但其实写作是一种自我修行,你永远不知道你写的东西是不是受欢迎,对此你也不必过分期待—— 尽管去写,去尽量写好,然后你自然会有所收获,尤其是内心的喜悦,这是千金不换的馈赠。
针对写作,尤其是技术文章的写作,我此前有几篇心得,有兴趣可以参考
三十分钟写作法
写作技术文章或图书的一些经验
我分享给大家的个人写作经验