为什么要坚持技术写作
一份关于技术写作的个人复盘:为什么开始写、写作难在哪、收益有哪些、又该如何坚持下去。
我从刚开始参加工作就有写东西的冲动,直到 2021 年 3 月才养成连续、有节奏的写作习惯。截至 2022-09-23,我已经累计输出 62 篇技术文章,月均 3 篇左右。单看这些数据平平无奇,但这件事给我带来了很多收获:
- 人生第一次有了持续的睡后收入——具体有多少?留个悬念,后面展开说;
- 学习完再以教授的心态做一次总结,完成从学到教的转化,对我来说学习效率非常高;
- 用心写出自觉足够好、足够完备的内容,既帮到自己又帮到别人,自然能提升个人乃至团队的影响力;
- 写作过程极其锻炼表达能力、逻辑思维,甚至同理心,我感觉这段时间以来自己的心智在逐步变得成熟;
- 个人和团队的技术输出足够多、行业影响力足够大之后,更容易吸引优秀人才,利好招聘。
接下来我从三个维度总结自己的写作体验:我是怎么开始写作的、写作的难点与收益以及如何坚持、最后立几个 flag。
1. 起因
在加入现在这个团队之前,我写博客的节奏基本属于三天打鱼两天晒网,平均两三个月才输出一篇,而且内容偏低质,多是学习笔记和总结。
来到字节后,今年三月有幸参加了一次部门组织的技术分享——前端打包构建专题,一不小心输出的内容还不错:《[万字总结] 一文吃透 Webpack 核心原理》,还拿了个写作奖:

于是我试着往知乎、掘金发,反响也不错,阅读、转发、点赞、收藏各方面数值都创下我职业生涯的最高记录,这对我这种俗人来说已经算人生巅峰了。
既然看起来还挺顺利,趁着这个兴头不如多写几篇,顺手再开个公众号。然后就一直坚持到现在,从四月到现在个人输出了 62 篇文章。
2. 我对技术写作的理解
2.1 问题
写技术博客是一件特别难的事情——至少对我来说很难。每一篇技术文章从起草到成稿至少需要一到两周,过程大致分三步:
- 学习:围绕主题查资料,但这个过程不一定顺利。就我经常写的 Webpack 而言,国内其实没太多现成的资料,往往得翻墙找外网,甚至直接读源码,很消耗脑力和体力。
- 实验:带着新知识的输入,设计大量实验,严谨地交叉验证——毕竟是要对外输出的东西,质量总得有保证,这个过程很消耗体力。
- 撰文:学习完、实验验证过,才开始总结成文。这个过程基本脱离了程序员熟悉的范畴,需要设计文章结构、前后呼应、起承转合。而且一句话、一个段落、一篇文章的好坏没有严格标准,我经常写完甚至不知道自己写得好不好、对不对,所以常在一句话上卡一个小时。
这个过程其实很反人性——工作已经很累了,为什么还要花时间精力去卷一件不确定的事?我认识的很多人一个月能走一遍这个流程已经很突破极限了,要持续、有节奏地输出特别难。我自己职业生涯前面大部分时间也都在有一搭没一搭地做这事。
2.2 收益
这事虽然难,但收益特别明确,在我看来至少有以下几方面:
- 高效学习:书面表达对叙述技巧、逻辑结构、体系化各方面都有更高要求,反向推动你主动查漏补缺,把点状离散的知识点串联成网,学习的主动性和效果都比单纯输入好很多;

- 扩大个人影响力:技术社区能帮作者触达更多读者,同样的内容被越广泛阅读,自然能帮到越多人,也反向增强作者的影响力;
- 写作本身也是一种管理手段:所谓上行下效,团队风气如何,最关键的变量在管理者自身。如果你期望团队保持活跃的技术氛围,那你自己首先得下场推动。从我的经验看,以身作则比耳提面命有用太多;
- 被动收入:虽然很少,但确实有一部分人通过出书、出小册、出教程的方式获得工资之外的被动收入。
在现阶段的我看来,写作是编码之外实现个人价值的一个非常重要的途径,某种程度上能缓解我对「35 岁魔咒」的焦虑。
2.3 如何坚持
聊完难点和收益,如果你觉得有必要开始写点东西,我这里提供一些坚持写作的技巧:
- 先从简单、熟悉的领域开始,选一个小的技术切面,输出自己的经验、观点、思考。前期不必过度追求质量,也不要怕写不好被质疑,先写起来,克服对写作的抗拒心理;
- 给自己定规则:一是设定每天、每周某个固定时段专门用于写作;二是设定输出周期,例如每周、每双周必须输出一篇,给自己一个 DDL;
- 动笔之前先规划好文章结构,适当读一些关于写作的书,推荐《九宫格写作法》《学会写作》《读书、治学、写作》《落花流水皆文章》《如何阅读一本书》;
- 写作期间找个清净的环境,手机静音,电脑关闭通讯软件,尽可能减少外部干扰;
- 写作、学习、实验的间隙,不要习惯性拿起手机或打开无关应用,集中注意力;
- 将技术社区的阅读量、点赞数、粉丝数视作量化指标,通过数值变化及时获取反馈,但记住初心比数值重要,不要为了迎合社区降低作品品质;
- 定一个中长期目标,例如一年内社区粉丝数破万、一年内写出一本书;
- 读点闲书。
这些都只是当前适合我的方式方法,不一定普适。但关键在于,一旦你决定要开始做这件事,就要始终如一,找到自我激励的方式然后持之以恒。
3. Flag
现在刚好到年底了,希望未来一年我能往前再走一点,包括:
- 启动可视化方面的学习,同时沉淀出比较高质量的系列文章,至少 10 篇;
- 积极参与一些开源的事情,有一些想法正在酝酿。
4. 八卦
4.1 流量密码
我平常主要维护知乎、掘金、公众号、SegmentFault 四个平台的账号,每个平台的特性不太一样,相应的引流涨粉手段也差别很大:
- 公众号:最强原创保护,没有之一;缺点是拉新手段单一,主要靠社交传播,最有效的涨粉方式是被大号转载,其次是加入技术群发文章;
- 知乎:技术大佬多,推荐算法应该是做得最好的,相应地对内容质量要求也更高,最有效的涨粉手段是大 V 点赞;
- 掘金:写作体验好,前端也特别多,但读者群体偏年轻,喜欢情感更饱满、表达方式更丰富的文章,不太适合我这种性冷淡风;
- SegmentFault:写作体验最好,社区活动也多,但流量单一,文章冲不上首页基本没什么阅读量。
现在我开始主攻微信公众号了,虽然阅读和粉丝都很少,但至少有点原创保护——我不希望辛辛苦苦熬夜写的东西被莫名其妙、未经同意就搬到各种奇怪的地方。
4.2 为什么主攻 Webpack
最开始选择 Webpack,一是团队内技术分享需要,二是社区里这方面高质量资料非常少,三是工作中有不少 Webpack 特别复杂的场景需求。
刚开始读源码就发现,Webpack 的复杂度远超其它前端开源项目,这激起了我的好胜心,我觉得以自己的智商应该能啃下这块骨头,于是沉下心学了很长一段时间,陆陆续续输出一些自觉比较有深度的文章。
文章数量起来之后,有几家出版社陆续找上门约稿,这侧面证明我好像有能力出一本这方面的书,于是后面更加投入 Webpack 的学习。至今我写的 Webpack 系列已经涵盖源码解析、性能优化、基础应用三方面的知识点,也陆续有一些同学加微信请教 Webpack 的问题,我一般都会尽力解答——除非实在忙不过来。
目前计划至少未来半年还是主攻这个主题,直到所有内容能组织成一个足够完备的知识体系。
4.3 谬赞
最近一年陆陆续续有不少人在文章后面留言,或者直接加微信,上来就是一句「大佬」,心里很是暗爽:




4.4 收入
估计这一部分是最多人关注的了。最近一年写作给我带来的被动收入有:
- 微信公众号每月都能收到一笔广告费,平均 5 元;
- 公众号读者赞赏,合计 2000;
- 拿到公司的技术写作奖,京东卡 1k;
- 收到若干简历,虽然很多内推失败了,但内推过程奖加起来应该也有 2200;
- 小册收入若干;
- 若干商务合作邀约,成了一次,700,以后不接了。
合计应该有若干 w 吧,够吃好几次帝王蟹了。

