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

作者:明明如月学长, CSDN 博客专家,蚂蚁集团高级 Java 工程师,《性能优化方法论》作者、《解锁大厂思维:剖析《阿里巴巴Java开发手册》》、《再学经典:《EffectiveJava》独家解析》专栏作者。

热门文章推荐

  • (1)《人工智能时代,软件工程师们将会被取代?》
  • (2)《如何写出高质量的文章:从战略到战术》
  • (3)《我的技术学习方法论》
  • (4)《什么? 你还没用过 Cursor? 智能 AI 代码生成工具 Cursor 安装和使用介绍》
  • (5)《我的性能方法论》
  • (6)《New Bing 编程提效实践 - 语言识别功能》

热门:学长主导的新星计划2023【AI 助力软件开发】学习方向,旨在引导大家学习 AI 工具的使用、学习如何写出高质量的技术文章。引导学员借助 AI 工具更好地学习,更快地解决问题。火热报名中,感兴趣快来报名吧!

目录image.png

一、背景

1.1 写作背景

最近 CSDN 举办创作之秋和国庆征文活动,作为创作之秋的“创作领航导师”,也需要对参与活动的同学进行的指导。
image.png
借着这个机会,对 “如何写出高质量的文章” 这个话题进行系统性思考,在这里进行分享,希望对大家写作有帮助。

1.2 写作经历

目前注册 CSDN 10年, 已经持续 7 年 文章创作数量超过 20 篇以上,获得了笔耕不辍 7级证书和实体勋章,在其他平台也发表过很多文章。
image.png
前一段时间也收到了 CSDN 笔耕不辍的实体勋章。
在这里插入图片描述


目前各平台博客阅读总量大致在 400 万左右。

目前主要作品有: 剖析《阿里巴巴 Java 开发手册》、《Effective Java》 独家解析、《性能优化方法论》、《Java 校招求职如何拿大厂 Offer》 等,有多篇文章被知名公众号转载。
image.png

二、为什么要写文章

image.png

2.1 写作是一种学习方法

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

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


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

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

2.2 写作可以锻炼思维能力

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


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

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

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

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

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

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

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

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

image.png

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

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

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

有些同学想写文章,但是又不太清楚该写什么。

下面给出一些常见的写作方向: 技术方向、业务方向、个人方向。
image.png
我认为只要对自己的学习有帮助,只要有自己的思考,都可以写。

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

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

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

五、如何写出高质量文章

5.1 战略

5.1.1 大量的输入

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

输入不要局限于计算机相关知识,包括哲学、心理学、物理学、生物学领域的常见知识都可以广泛涉猎,这些学科对我们深入理解计算机相关知识有较大帮助。
image.png
心理学中的很多定律对我们起出有吸引力的标题,做好文章的运营有较大帮助。
生物学中的演化论和遗传理论系统和架构演进也提供了思想支撑,生物学的遗传思想也是遗传算法的主要依据。
化学中学到原子是万物的基础,但是不同原子的排列方式构成了世间万物,不同结构的系统、不同结构的架构稳定性、拓展性也完全不同。
在这里插入图片描述


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

image.png

经典的技术图书和介绍常见中间件原理的图书有时间都要反复阅读,如《A Philosophy of Software Design》、 《深入理解计算机系统》、《深入理解 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
大家可以按照这个框架来写,但无需拘泥于其中 W 和 H 的顺序,可以适当变通和创新。

(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

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

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

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

下图为写作猫对本文部分内容检查的截图:
在这里插入图片描述

使用 ChatGPT 或 New Bing ,一些基础的概念讲解,一些基本的代码示例,都可以考虑让 ChatGPT 帮助编写。
在这里插入图片描述

5.2.7 规范写作格式

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

六、总结

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

如果你有不同的看法、有补充的建议,欢迎在评论区和我交流。
在这里插入图片描述

总之,高质量的文章少不了写作前大量的积累,深入地思考;离不开写作中认真的态度;离不开写作后的斟酌修改。

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

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


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


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

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.rhkb.cn/news/14634.html

如若内容造成侵权/违法违规/事实不符,请联系长河编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

原力计划来了【协作共赢 成就未来】

catalogue 🌟 写在前面🌟 新星计划持续上新🌟 原力计划方向🌟 原力计划拥抱优质🌟 AIGC🌟 参加新星计划还是原力计划🌟 创作成就未来🌟 写在最后 🌟 写在前面 哈喽&…

博弈论——选举/投票(voting)

文章目录 前言一、相对多数投票法(Plurality Voting)二、孔多塞准则(The Condorcet Criterion)三, 谷轮法(Copeland method四,波达计数法(Borda Count)五,选举…

Java 设计模式(java design patterns)

什么是设计模式? 前辈们,在长期开发中为了解决某种重复出现的问题,经过长期的总结,代码结构优化,最终确定一套解决办法。 为什么学习设计模式? 对程序设是有帮助的,提高代码额可重用性&#…

叫ChatGPT用html+css+js写一个圣诞节代码,看看什么样子?

最近ChatGPT这么火,那就让他给我写点代码吧。 如何注册一个账号,参考:注册ChatGPT详细指南 注册不了的小伙伴们,咱们评论区见,问一个最想问的问题,看到就给你回复! 我已经注册好了,…

前端实现六一儿童节祝福语分享,烟花特效助您表心意

部分数据来源&#xff1a;ChatGPT <!DOCTYPE html> <html lang"en"><head><meta charset"UTF-8"><title>六一儿童节祝福</title><style>body {background-image: url(https://picsum.photos/1920/1080);backgr…

chatgpt赋能python:10个好玩的Python代码-让编程更有趣!

10个好玩的Python代码- 让编程更有趣&#xff01; 作为一名有10年Python编程经验的工程师&#xff0c;我深刻理解到编程可以是一件令人兴奋和有趣的事情。Python是流行且多才多艺的编程语言&#xff0c;具有简洁易懂的语法和丰富的库&#xff0c;可以帮助开发人员快速轻松地实…

大型语言模型与文本摘要

大型语言模型与文本摘要 基于大型语言模型的抽取式摘要基于大型语言模型的零样本跨语言摘要基于大型语言模型的问答式摘要通过摘要任务评估大型语言模型的事实一致性基于大型语言模型的摘要事实一致性评估器未来方向大型语言模型的自我偏好基于大型语言模型生成提示基于大型语言…

ChatGPT玩起来真是上头,AI广泛应用元年体验AI之美

概述 ChatGPT是由人工智能研究实验室OpenAI在2022年11月30日发布的全新聊天机器人模型&#xff0c;一款人工智能技术驱动的自然语言处理工具。它能够通过学习和理解人类的语言来进行对话&#xff0c;还能根据聊天的上下文进行互动&#xff0c;真正像人类一样来聊天交流&#xf…

推荐一款idea神级代码插件【Bito-ChatGPT】而且免费!- 第9篇

历史文章&#xff08;文章累计460&#xff09; 《国内最全的Spring Boot系列之一》 《国内最全的Spring Boot系列之二》 《国内最全的Spring Boot系列之三》 《国内最全的Spring Boot系列之四》 《国内最全的Spring Boot系列之五》 《国内最全的Spring Boot系列之六》 文…

ChatGPT - 获取简短的书籍摘要的Prompt

文章目录 Prompt例子 Prompt “总结[书籍名称]&#xff0c;并给我列出最重要的学习和观点。”例子

小米AX6000开启SSH后的高级用法

买的是RA72版本的AX6000,售价599,高通的CPU。 看看高颜值和唬人的外观,图示如下: 关于AX6000开启SSH的方法有很多介绍的,这里关键讲几点: 先升级RA72对应的固件,降级到41版本。 附上:miwifi_ra72_firmware_59812_1.0.41.bin 版本固件地址: http://cdn.cnbj1.fds.a…

为什么我觉得这次的chatGPT是真的智能AI

写在前面 openAI在2022年11月推出了chatGPT&#xff08;全称Chat Generative Pre-trained Transformer【聊天生成型預訓練變換模型】维基百科&#xff09;说的直白一点就是一个目前为止&#xff0c;这个星球上可以见到的最智能的机器人&#xff0c;他可以完成一些人类认知范围内…

第四届中国计算机教育大会“人工智能与大模型论坛”将于4月22日厦门召开

2023 年 ChatGPT 全球爆红&#xff0c;瞬间在国内引起了对大语言模型的热议。全球头部科技大厂再次站上了同一个赛道&#xff0c;很多 AI 领域的创业者、创投机构行动了起来&#xff0c;开启了大语言模型“军备竞赛”。人工智能与大模型技术的发展&#xff0c;离不开高校与产业…

chatgpt赋能python:Python培训:成为一名高薪Python工程师

Python培训&#xff1a;成为一名高薪Python工程师 Python已成为当今最流行的编程语言之一&#xff0c;它广泛应用于人工智能、机器学习、数据科学和Web开发等各个领域。许多公司都在寻找经验丰富的Python工程师来开发他们的产品。如果你想成为一名高薪Python工程师&#xff0c…

记一次和ChatGPT一起排查线上问题

某日现场技术支持找到了我&#xff0c;问我有个数据上报的功能&#xff0c;记录的都是上报失败&#xff0c;让我排查一下。我第一印象当然是甩锅&#xff0c;啊不对问一下情况&#xff0c;准备排查问题。 先交代一下基础情况&#xff1a;功能就是我们将我们系统的数据上报到对方…

AI 2.0时代,再看消费物联网十年

本文是「光锥智能」的「十年系列」之二&#xff0c;对前沿科技影响千行百业数字化和智能化的复盘和展望&#xff0c;第一篇《中国芯片投资十年》获得了业界科技、财经、创投和芯片垂类媒体的广泛关注。 【划重点】 从消费互联网、移动互联网到万物智联&#xff0c;正是一个“…

月薪13K!国企小哥抛弃“铁饭碗”转行测试,亲身经历告诉你选高薪or稳定

对于很多程序员来说&#xff0c;国企or大厂一直都是一个两难的抉择&#xff0c;该选择稳定还是高薪&#xff0c;许多小伙伴都在这个问题犯了难。 可他却用自己的努力和实际行动做出了最好的选择&#xff0c;为自己的职业道路画上了浓墨重彩的一笔。 话不多说&#xff0c;一起…

36张图,一次性补全网络基础知识

点击上方 前端Q&#xff0c;关注公众号 回复加群&#xff0c;加入前端Q技术交流群 转自&#xff1a;网络工程师笔记 OSI和TCP/IP是很基础但又非常重要的知识&#xff0c;很多知识点都是以它们为基础去串联的&#xff0c;作为底层&#xff0c;掌握得越透彻&#xff0c;理解上层时…

基于LLM的生成式AI正在快速变革RPA人机交互

如果问RPA对程序开发以及自动化有哪些贡献&#xff0c;其中一个答案便是它改变了人机交互&#xff08;HCI&#xff0c;human-computer interaction&#xff09;。 在传统工作流自动化工具中&#xff0c;软件开发人员不得不生成一个操作列表&#xff0c;使用内部应用程序编程接…

大模型时代来临,基于LLM的生成式AI正在快速变革RPA人机交互

从“人RPA”到“人生成式AIRPA”&#xff0c;LLM如何影响RPA人机交互&#xff1f;换个角度&#xff0c;从人机交互看LLM如何影响RPA影响程序开发与流程自动化人机交互的RPA&#xff0c;现在也要被LLM改变了LLM如何影响人机交互&#xff1f;生成式AI怎么改变RPA人机交互&#xf…