卓越笔触：打造高质量文章的艺术与科学-京东云开发者社区

# 引言

在信息爆炸的时代，写作不仅是一种表达，更是一种影响力的体现。无论是为了提升个人品牌，还是为了增强团队的技术氛围，或是推动集团的技术影响力，一篇高质量的文章都能起到关键作用。在这次分享中，我将探讨为什么我们需要写好文章，并提供实用的技巧，帮助大家提升文章的质量。希望这次分享能激发大家的写作热情，共同推动技术交流与知识传播的进程。

# 一：我们为什么要写一篇好文章？

## 1、对于集团

2024年巴黎奥运会已结束，体育赛事不仅是速度和力量的较量，更是各国**综合实力和软实力**的集中展示。

![img](https://apijoyspace.jd.com/v1/files/TdZuotzifhVzOm1ygKRw/link)

8月5日，《财富》发布了2024年世界500强排行榜，京东集团排名较去年**提升5位，居第47位**，排名**蝉联国内行业首位**，京东已**连续九年跻身世界500强**。

![img](https://apijoyspace.jd.com/v1/files/OGHBvgBTxguehsxSqOcq/link)

为什么要列举这两则信息“软实力也体现硬实力”，我这里想说明一下自己的感受。

我们在行业内是有领导地位的，综合实力绝对的行业翘楚，但是软实力方面，如果有一个技术影响力的排名，我觉得我们还是有一些差距的。

Felix 说希望通过 3-5年的土壤培养，让外界对于京东的产品同学更认可，能称赞。

同样技术同学呢？我个人的看法：神灯就是一个很好的培养平台和渠道。通过一些优质的文章，让大家不闭塞在自己的圈内，另外筛选的优质文章让外界同样知道京东的技术底蕴也是很深厚的。

神灯运营组已经做的很好了，有奖品驱动，有流量分发，有当下正在进行时的创作计划。那么我们创作者应该怎么做，我想就是写一些优质的文章，为集团技术影响力发一份光，增一份热。

## 2、对于团队

一方面通过撰写文章促进团队成员之间的知识交流，带动团队内的技术氛围。-王先科《【交付高质量，用户高增长】-用户增长质量保证方法论》

另一方面希望把“有价值的知识传递给当前以及未来的人”这件事做得更好。-GOC《零售线上系统稳定性治理规范——变更篇》《零售线上系统稳定性治理规范——应急篇》等等

隐藏彩蛋：公司其他团队同学和外部同学，通过看了我们的技术文章，进行简历投递。

## 3、对于个人

- 提升自身影响力
- 加强对技术的理解深度
- 结交一些志同道合的朋友
- 获得成就感和满足感
- 晋升时候的软指标

# 二：我们怎么写好一篇好文章？

## 1、换位思考

应当试着站在读者的角度思考，讲清楚。是什么？为什么？怎么办？

试着想清楚以下 6 个问题，如果没有，不要轻易进入下一步。

*1. 你写这篇文章的目的是什么？
2. 你的目标读者是谁？
3. 读者对于该主题的知识储备如何？
4. 读者对于什么内容更感兴趣？
5. 读者关于这个主题，可能的痛点和需求点是什么？
6. 你希望读者读完获得什么收益？*

-根据我写的《万字长文，聊聊我在锦礼成长的这一年》的总结，给大家一些想法，再写这一篇文章的时候，我最初的目的是写纯技术题材，总结一下锦礼侧的一些技术方案，因为作为一名研发嘛，但是如果仅是技术类，别说产品同学，就连同是技术同学，在不一样的业务模式下，大家都会不明觉厉，因为隔行如隔山，会有一定的差异性。后来将纯技术内容与更广泛的主题（关于成长和沟通的）相结合**扩大受众范围**。这种做法类似于在电商领域中增加产品种类、产品功能的方式来扩大需求端，产生更大拉力的概念，因为多元化内容可以使原本只对技术感兴趣的读者群体之外的人们也对文章产生兴趣。

内容专注和受众广泛矛盾吗？并不一定矛盾，不同的内容分类对应不同的受众人群。这个我已经替大家证实了，因为在这篇文章发布后，有产品和业务同学给了我很多反馈。

## 2、灵感笔记

一些思考过程和想法用文档的形式记录下来。不用太过细致，一开始一定会比较混乱，重在记录清楚所有涉及到的重点内容，并且要抽时间维护和整理。有记录在就可以很快出起来，这就是所谓的"**碎片化记录，结构化整理**"。

没有灵感怎么办？

*1. 平时记录思考过程和想法
2. 认真写设计文档
3. 参考同类型文章
4. 请教技术专家*

灵感的获得有偶然性，要养成随时记录灵感的习惯。推荐几个可以用于记笔记的小工具：苹果备忘录、幕布、微信文件传输助手、京me 文件传输助手。

分享一下近期我的文件助手中的部分素材：

> -风是透明的河流，雨是冰冷的流星。 摘自李娟《我的阿勒泰》

>-用尽量少的产品满足用户最关注的需求，是一种超凡的能力。少就是多，背后是极为精准的行业发展与用户需求洞察、极为清晰的产品/战略思路，以及基于强大产品力的超凡自信。摘自雷军《小米创业思考》

>-请不要相信，胜利就像山顶上的蒲公英一样，唾手可得，但是请相信，世上总有一些美好的值得我们全力以赴，哪怕粉身碎骨。摘自足球诗人贺炜

>-到目前为止，我们都将重点放在了防止可靠性和安全故障的设计原则和实现方法上。不幸的是，想要达到完美的可靠性和安全性，成本通常很高，因此不切实际。我们必须假设预防机制有失败的可能，因此需要制订计划来检测故障并从故障中恢复。摘自《Google系统架构解密：构建安全可靠的系统》

## 3、选题三则

在我看来，值得写的文章主题最好满足以下三点。

*1. 这个主题是让你有分享欲的。
2. 文以稀为贵，写之前可以在论坛/社区中搜索一下，较少人写的话题往往更好。
3. 文章的内容对他人有价值，不能只为了自嗨。*

比如：

>-《关于京M换-动态头像》
>-《理解Kafka设计理念》
-《哎呀，当时怎么没有想到》
-《从校招新星到前端技术专家的成长之路》
-《“深淘滩，低做堰”，快递快运终端技术618保障之路》
-《ChatGPT是如何产生心智的？》
-《一群AI卖保险的程序员》
-《网易云音乐崩了！冲上热搜第一...让我们复盘一下》等等

## 4、文脉架构

文章有个好的结构/框架，首先可以让读者很快就对整个文章的脉络比较清楚，帮助读者理解文章的逻辑，容易给他们留下深刻印象。其次也方便读者直接跳到自己感兴趣的章节进行阅读。

这就不得不提一下**金字塔原理**了，金字塔原理是一种重点突出、逻辑清晰、主次分明的逻辑思路、表达方式和规范动作。（京 me 学习平台有不少相关课程，感兴趣的可进行翻阅学习）

四大原则如下：

>1. **结论先行**：只有一个中心思想，并且放到最前边。比如：在引言和开篇中就亮出观点，吸引读者。
>2. **以上统下**：一个层次上的思想，都是下一层次思想的总结和概述。比如：每个段落之间做合适的过渡和转折。
>3. **归类分组**：把具有共同点的素材进行归纳分组。比如：先有提纲：先列目录，再写内容。
>4. **逻辑递进**：同一组的思想具有某种内在的逻辑关系。比如：在文章末尾总结全文，升华主题，拓展思考。结尾给出展望。

## 5、图胜千言

相信看过技术文章的同学，都会遇到大段文字读不下去的情况，特别在这个短视频的时代。这里就涉及文章配图的问题。

**一图胜千言**，大部分人都是先看图，再看字，这是有科学依据的。人脑处理图片信息是并行的，而处理文字信息则是串行的。人脑处理图片的速度是处理文字的6万倍。

特别在技术设计上，如果靠文字描述解释清楚，那是极其晦涩难懂的。通过一个架构图，或者流程图能够使复杂问题简单化，抽象问题具体化。类比我们在数学中使用到的数形结合思想。

>-马酩《“深淘滩，低做堰”，快递快运终端技术618保障之路》备战全景图 《利用大模型服务一线小哥的探索与实践》智能问答的实现方法流程图
-赵姣姣《从校招新星到前端技术专家的成长之路》创意中心架构图

推荐几个画图的软件 ：Excalidraw、joyspace、亿图

## 6、内有乾坤

说一千道一万，决定一篇文章质量的最重要的因素还是：**内有乾坤，言之有物。**

避免成为了标题党，导致外强中干。就像我们打开一个商品标题规格描述不一致，打开文章后，给读者不好的体验。

以下是关于怎么让自己的文章干货更多的一些建议：

*1. 更高的抽象层次，尽量避免描写过多技术细节，上升为方法论。
2. 专业性，在自己熟悉的专业领域写作，避免传达错误信息。
3. 有深度。体现在领域的全面掌握。
4. 加入基于自身实践的理解，而非翻译。*

>-李军亮《前车之鉴，后事之师——过往三年大促线上问题盘点》
>-王鑫《京东物流软件系统稳定性建设方法》
>-陈强《记一次我与黑客的网络交锋实录》
>-鞠明业《分布式KV存储JIMKV - 成本低！性能高！更可靠！》
>-刘宁《鸿蒙跨端实践-布局方案介绍》

## 7、精雕细琢

很多技术很好的同学都会遇到这样的问题，虽然我们的文章主题不错，结构也还可以，内容干货也比较多，但是语言晦涩，排版不好。这样就会导致我们的读者读着读着读不下去。这时候就要求我们在文章发布之前带着工匠精神去精雕细琢，多润色几遍。

那么如何润色？

*1. 润色可以从以下三个角度：语言、章节、排版
2. 语言润色的目标是追求精简、准确、生动*

写完后，通读自己的文章几遍。需要注意的是准确和生动并不矛盾，而是相辅相成、辩证统一的两个方面，**在专业术语上和行业共识的描述上使用客观的、严谨的数据和事实，在表达方式和思路的阐述上追求生动。**

记得之前有看一些漫画类的技术文章，比如**如何给女朋友解释什么是负载均衡**等等这类的文章，通过生活中常见的例子通俗易懂的描述了技术点。

这个也尤其重要，毕竟**把复杂的东西讲简单，把简单的东西讲深刻，向来不是一件容易的事情。**

## 8、博观约取

“**博观而约取，厚积而薄发**”。出自苏轼《稼说送张琥》这里指：广泛地观察（阅读）并从中提炼精华。

如果有可能的话，尽量养成多读书的习惯（不限于技术文章）。好的文章和书籍，可以学习到很多好的行文习惯和写作思路，对写好技术文章很有帮助。

当然大家肯定都比较忙，我平时采用的是听书，听 B站，看技术文章，并且过程中，有意识的积累素材，比如在文章中我会引用罗翔老师的话。另外就是多模仿，站在巨人的肩上去看世界。多写，刻意练习。不要怕写不好，事后复盘，逐渐改进。

很多同学会有这样的想法，一直纠结要不要写一篇呢？写的不好会不会怎么怎么样。不要想这么多，很多事情就像旅行一样，当你背上行囊出门那一刻，最困难的部分其实已经完成了。

## 9、以文会友

最后，我特别喜欢项目组在第一篇文章中提到的 **以文会友**。

方法：通过群分享，神灯推广，社区活动等等，让更多同学阅读到自己的文章，参与到文章的讨论和建议中。

其实这背后也有一定的**流量思维**。比如：为什么一个视频会这么多人观看？为什么一家饭馆这么多人排队？

大家可以思考一下：一篇阅读量较高的文章（比如每周精选的文章），我们是不是更倾向打开看看。**羊群效应**无处不在。尽在不言中啦。

我相信，我是足够幸运的，所以今天能和大家交流分享。所以也希望大家在日常阅读中，读到了优质的文章，推荐一下以及项目组可以更多的挖掘我们的创作者新星们。因为就像业界对我们的认知一样，~~钱多话少xxx~~，程序猿还是很含蓄的。
***

以上就是我所有的分享，供大家参考和共勉。感谢各位的时间。

# **加入社群**

欢迎加入【神灯创作者计划社群】，每周五会有创作导师分享创作经验、点评优秀文章，帮助你获取更多创作干货，成为更好的社区创作者。

**加入方式：手机端扫码，PC端可搜索群号：10210504356**