如何写出高质量的文章:从战略到战术

目录image.png

一、背景

1.1 写作背景

最近 CSDN 举办 创作之秋的活动,作为“创作领航导师”,需要对参与活动的同学进行简单的指导。
image.png
借着这个机会,对 “如何写出高质量的文章” 这个话题进行了思考,也进行了直播分享。
现在,结合直播中讲述的重点内容和直播后听众提的一些不错的问题,整理成文,希望对大家有帮助。

1.2 写作经历

注册 CSDN 10年, 持续 7 年 文章创作数量超过 20 多篇,在其他平台也发表过很多文章。
image.png
目前各平台博客阅读总量大致在 400 万左右。
目前主要作品有: 剖析《阿里巴巴 Java 开发手册》、《Effective Java》 独家解析、《性能优化方法论》、《Java 校招求职如何拿大厂 Offer》 等。
image.png

二、为什么要写文章

image.png

2.1 写作是一种学习方法

费曼学习法是一种比较高效的学习方法,通过教别人来验证自己是否真正掌握知识的学习方法。有效地技术写作也是一种类似的通过教别人来深化自己对某个知识点理解的过程。

只有能“讲清楚”才代表真正想清楚,真正理解了某个知识点。
在这里插入图片描述


写高质量的文章某种程度上和 “写论文” 有些类似。写技术文章需要查阅各种相关资料,查看源码、查看相关的技术图书、查看类似的文章的观点、甚至需要查看论文等,对学透某个知识点非常有帮助。

有时候有些文章自以为写的很完善,评论区其他人指出一些问题或者给出一些补充,才发现自己并没有真正学透这个问题,对这个话题的理解就会更进一步。

2.2 写作可以锻炼思维能力

并不是多写文章,思维能力就一定能得到锻炼。
在这里插入图片描述


如果能借着写文章这个机会,对某个知识点进行系统化地思考,并能通过结构化的方式表达,通过多次刻意练习,就能够锻炼自己的思维方式。

2.3 写作可以提高个人影响力

如果能够持续输出高质量的文章,就会有得到更多地曝光,就会有更多的机会。

甚至会有人来寻求合作,出专栏、出书等。

通过持续输出高质量的文章,也能够积累更多粉丝,认识更多朋友。

三、什么是高质量的文章?

高质量的文章通常具备以下特点:

image.png
另外,通常来说很多知识付费平台的热门专栏、很多知名开源项目的官方文档、很多大厂的技术公众号的文章质量也非常高。

扫描二维码关注公众号,回复: 14521997 查看本文章

image.png

其中阿里技术的:《对抗软件复杂度的战争》,就是一篇不错的高质量文章案例。

image.png
大家可以大致浏览一下,该文图文并茂;引用文章众多,论证充分;能够结合源码和经典的理论;能够引发读者的思考。

四、常见写作方向有哪些?

有些同学想写文章,但是又不太清楚该写什么。
下面给出一些常见的写作方向: 技术方向、业务方向、个人方向。
image.png
我认为只要对自己的学习有帮助,只要有自己的思考,都可以写。

技术方向:可以是对某个技术原理的介绍,某个技术方案的介绍,技术架构的设计;源码的设计思想对经典的图书、文章的笔记;某个问的解决方案,日常开发遇到的坑点分享都可以。

业务方向:可以讲自己所做业务的思考、业务的逻辑,商业模式的思考等。

个人方向:可以分享自己工作中的思考;对项目、晋升的复盘;个人在某个领域的成长经历等。

五、如何写出高质量文章

5.1 战略

5.1.1 大量的输入

没有持续地输入,就很难持续输出。

输入不要局限于计算机相关知识,包括哲学、心理学、物理学、生物学领域的常见知识都可以广泛涉猎,这些学科对我们深入理解计算机相关知识有较大帮助。
image.png
心理学中的很多定律对我们起出有吸引力的标题,做好文章的运营有较大帮助。
在这里插入图片描述


专业基础必不可少,尤其是非科班出身的同学,一定要加强专业基础的学习;工作中常见的技术栈的源码有时间都可以系统地学习一下。

image.png

经典的技术图书和介绍常见中间件原理的图书有时间都要反复阅读,如[《A Philosophy of Software Design》]、(https://book.douban.com/subject/30218046/) 《深入理解计算机系统》《深入理解 Java 虚拟机》《阿里巴巴 Java 开发手册》《领域驱动设计》《重构》《代码整洁之道》《设计模式之禅》《Redis 深度历险》《HBase 不睡觉书》《Elasticsearch 实战》《深入理解 Apache Dubbo 与实践》《深入理解 Kafka 核心设计与实践原理》等。
image.png
一些常见知识付费平台的畅销专栏,都可以买来学一学。技术专栏的好处在于比图书更生动有趣,相对更深入浅出,更结构化一些。

5.1.2 深入的思考

想写出高质量的文章一定要对相关的主题有过系统地深入的思考。

可以尝试和经典的计算机科学领域的理论、软件工程领域的理论, 专业基础中的相关实践相结合。
在这里插入图片描述


也可以尝试从物理学、生物学、经济学甚至哲学领域的重要思想结合。

5.1.3 深入地调研

写写出高质量的文章,需要充分阅读写作主题相关的各种文章、论文、经典图书、源码等。
在这里插入图片描述


这样对写作主题的论述会更加全面,有更多写作的素材。

5.1.4 没明确受众

写作之前要明确文章的受众,根据受众调整语言风格、文章结构等。

换位思考受众的核心诉求,就更容易直击痛点,输出干货。

5.1.5 刻意练习

我们知道了高质量文章的特点,多去阅读一些高质量的文章之后。
在这里插入图片描述


写文章就可以通过模仿来“刻意练习”,逐渐提高写作能力。

5.1.6 厚积薄发

大家平时读书时突然对某个知识点有不一样地理解,可以及时记录。

阅读经典的图书或者文章时,可以写读书摘要,读书笔记,输出自己的理解。
在这里插入图片描述


日常工作中遇到一些 BUG 、代码审查中遇到的一些有意思的问题,都可以积累下来。

日常工作中遇到的问题一定要深挖背后的原因,不仅要解决问题,还要知其所以然,增加深度。

工作之余,建议主动阅读经典的图书、专栏、文章,增加广度。

通过不断地积累,不断地思考,就会有创作欲望,就容易写出高质量的文章。

5.2 战术

5.2.1 起好标题

关于起好标题,主要推荐三个方向:数字法则、给出结论和价值、激发好奇心。
image.png
数字法则:在标题包含一些具体的数字,就显得更具体。
给出结论和价值:在标题中体现出文章的价值,可以吸引对相关话题感兴趣的人来阅读。
激发好奇心:起一些容易激发读者好奇心的题目,更容易得到关注,但一定要确保名副其实,否则会容易引起反感。

5.2.2 列好提纲

作为 Java 工程师,大多数同学都知道,想要做好项目,一定要充分理解需求,并设计完善的技术方案,再动手开发。
读过研究生的同学也很清楚,在论文写作之前,定好目录很重要,目录斟酌好之后再进行写作就比较容易,也减少了修改的成本。
image.png

我最近写的《猿创征文|弃文从工,从小白到蚂蚁工程师,我的 Java 成长之路》就在目录上下了一些功夫,定好目录之后写起来心里就比较清晰,写作就一气呵成。

5.2.3 行文技巧

(1) 2 W 1 H

大多数高质量的文章,包括本文整体符合 2 W 1H 的行文结构,即是什么、为什么、怎么做。
下列思维导图是《代码重构之道》的文章结构
image.png

(2)Zoom In / Zoom Out

想写出高质量的文章,不应该只停留问题本身的层面,应该能够见微知著。
主动从不同的尺度看问题,从不同的尺度来描述问题。

下面思维导图是《对抗代码复杂度的战争》(阿里技术)文章的基本结构,即从微观和宏观角度来讲代码复杂性的问题。
image.png

(3)视角思维

有些文章可以尝试从不同的视角来写作,对问题的分析就会更加全面,对问题的解析就更本质。

如之前读过孤尽老师的解析同步和异步、阻塞和非阻塞、并行和串行概念的文章时,发现孤尽老师从函数调用、线程、CPU 的视角去分析这些概念,就如醍醐灌顶一般,对这些概念的理解特别透彻。

如果想写代码审查相关的高质量文章,就可以分析代码审查这件事有哪些角色,分别针对这些角色去写作就非常全面,更加结构化。
image.png

(4)时间视角

如果文章部分内容和时间有关,可以不同的事情划分成不同的阶段来描述,更结构化,也可以可以配一些 timeline 风格的图。

《阿里巴巴 DevOps 实践手册》 传统评审流程的问题配图:
image.png

(5) 本质思维

主动去思考很多问题的本质,写作时最好能点出问题的本质,文章会更有价值。

如下图所示,分布式缓存、分布式锁、分库分表中间件、领域驱动、消息队列等都是通过增加中间层来解决特定问题的方法。
领域驱动:通过增加领域层实现核心业务的稳定性,提高内聚降低耦合。
分布式缓存:通过增加缓存,通过空间换时间,实现更好的性能。
中介者模式:通过增加中介类,处理不同类之间的通信,降低耦合。
image.png

5.2.4 文章完整性

推荐大家通过一篇文章或一系列文章讲一个问题、一个技术讲透。
在这里插入图片描述

如很多文章看到标题就知道能够完整的讲述某个话题,很多读者就更愿意读: 《编写提测文档的正确姿势》、《原来源码还可以这么读》、《代码审查的正确姿势》、《性能优化方法论系列》、《我的成长之路》、《Spring 官方文档读书笔记系列》等等。

5.2.5 深入浅出

技术写作难免遇到一些枯燥的概念,可以考虑使用生活化比喻让深奥的概念变得通俗易懂。

如:《备忘录模式》
image.png

5.2.6 利用好工具

前面讲到高质量的文章的重要特征之一就是“图文并茂”。
可以使用 PlantUML 、Draw.io 、Power Point 、Keynote 、tweetlet 进行配图。

使用 tweetlet 可以将文本变为比较美观的图片作为文章配图。
image.png
可以使用 carbon 将代码转为比较美观的图片作为文章配图。
image.png

使用凡科快图搞定设计图怪兽等设计文章的首图、封面等。

使用 UnsplashPexelsPixabay 等选择和主题相近的配图,让文章读起来更轻松。
image.png

可以使用思维导图列提纲、可以使用写作猫进行语法和错别字检查,避免出现过的错别字。
image.png

写作猫非常强大,可以快速识别错别字,可以帮助我们减少很多低级错误,节省很多时间。
在这里插入图片描述

5.2.7 规范写作格式

推荐阅读 : 《中文文案排版指北》
大多数同学写作最常见的问题是不同章节之间没有空行,文字过于密集。英文单词、数字前后没有空格,可读性较差。

六、总结

本文主要结合自己的写作经历,从战略和战术两个层面讲述如何写出高质量的文章,希望对大家写作有帮助。

如果你有不同的看法、有补充的建议,欢迎在评论区和我交流。

最后,为了更好地帮助大家理解这些原则如何在实践中运用,给一个简单的案例:《小代码大智慧: FilenameUtils.getName 函数分析》

另外,如果你足够细心,你会发现本文也是按照文章说推荐的结构和工具来写作的。本文的标题也符合“给出结论和价值”的思想,采用了 2W1H 的写作思路,使用了凡科快图进行封面设计,使用 Xmind 做目录设计,使用 unsplash 和 keynote 配图、参考《中文文案排版指北》的格式,使用写作猫进行错别字检查等。


创作不易,如果本文对你有帮助,欢迎点赞、收藏加关注,你的支持和鼓励,是我创作的最大动力。


CSDN 【创作之秋】 写作活动火热进行中,欢迎加入学长的团队,丰厚礼品等你来拿,详情参见:https://bbs.csdn.net/topics/608207564

猜你喜欢

转载自blog.csdn.net/w605283073/article/details/127063601