跳到主内容

技术写作三年复盘:一年 20 篇文章带来的职业复利与 5 步写作法 ​

三年前的组会上,有位老工程师半开玩笑地问我:「你每周熬夜写文章,涨工资了吗?」当时我支支吾吾答不上来。三年后的今天,我可以拿数据回答这个问题了:累计发布 60 多篇文章,其中 20 篇左右被技术社区转载;靠文章接到过两次猎头的主动邀约、一次出版社的约稿;更重要的是,写作逼着我把 30 多个只知其然的技术点学到了知其所以然。这篇随笔把这三年沉淀的方法完整摊开。

写作的三重复利:一张简历放不下的资产 ​

技术写作的第一重收益最直接:它是一张可检索的个人名片。简历是被动等待筛选的,文章是主动证明能力的——当我把一次线上事故的排查过程写成复盘,面试官的问题就从「你负责什么」变成了「这个方案为什么这么设计」,主导权完全不同。第二重收益是倒逼学习,可以理解为费曼技巧的工程版:很多技术点看的时候觉得懂了,落笔写的时候才发现「这个参数到底是谁传进来的」根本说不清。写不清楚就是没想清楚,文章是我最诚实的知识审计工具。第三重收益是素材库效应:写过的东西不会消失,三年里的晋升述职、内部分享、面试自我介绍,素材几乎全部来自文章存货。算一笔账:一篇两千字的深度文章平均花 8~10 小时,但它三年内平均会被复用 3~5 次,边际成本趋近于零——这是我目前能想到的、工程师投入产出比最高的自我投资之一。

写不下去的三个真相 ​

真相一:完美主义。很多人第一篇文章想写成传世之作,憋三个月憋不出开头。解法是降低单篇预期:目标不是写「好文章」,而是写「诚实的技术记录」——我踩了什么坑、怎么定位的、结论是什么。读者要的不是文学,是可复用的经验。真相二:选题焦虑。总想写别人没写过的题目,结果发现所有题目都被写过了。换个视角:同一个技术点,你的场景、你的数据、你的取舍和别人的都不一样,「我的实践」本身就是新意。我给自己定的规则是:只写自己动手验证过的内容,宁可不写,不搬运。真相三:反馈缺失。发了三篇没人看就放弃,是大多数人的终点。解法是调整反馈周期预期:前 10 篇属于「冷启动期」,数据差是常态;把反馈来源从阅读量换成「三个月后我能不能搜到并看懂这篇文章」——写作首先是写给未来的自己。

我的 5 步写作法与 AI 工作流 ​

第一步,选题分级。我把选题分成 A/B/C 三级:A 级是自己踩过坑、有真实数据和复盘的实战题材,优先写;B 级是把最近学透的东西讲给别人听;C 级是热点评论,一年不超过两三篇——热点文的寿命通常不超过一个月。第二步,骨架先行。动笔前先只写小标题,每个标题下面用一句话写「这一节要给读者什么结论」,结论串联不起来就说明结构有问题,此时调整的成本接近于零。第三步,AI 辅助初稿与挑刺。我的分工原则是:初稿必须自己写,AI 负责当「最挑剔的读者」。写完初稿后把全文丢给 AI 做三类检查:

text
请以最挑剔的技术读者身份审阅这篇文章:
1. 逻辑漏洞:哪些结论缺乏论据支撑?哪些推导步骤跳跃了?
2. 表述问题:哪些段落前后矛盾、概念混用?
3. 读者视角:一个不了解背景的读者会在哪里跟丢?
只列问题,不要重写。

注意「只列问题,不要重写」这句很关键——让 AI 直接重写,文章会慢慢失去你的表达习惯,变成千篇一律的「AI 腔」。第四步,冷却自查。写完放一天,第二天通读做减法:删掉所有「简单来说」「众所周知」,砍掉与主线无关的支线。第五步,发布与复盘。记录每篇的阅读、评论与搜索关键词,评论里的疑问是最好的下一篇选题池——我现在的选题池里,一半以上来自读者评论。

从今天开始的前 90 天 ​

如果你还没开始,给出一份最小行动清单:第 1 周,注册一个发布渠道(博客平台或自建站点都行),写第一篇「踩坑记录」,题材就用上周工作里真实遇到的 bug,800 字即可,写完当天发布;第 2~4 周,每周一篇,全部选 A 级选题,允许自己写得糙;第 5~8 周,引入骨架先行与 AI 挑刺流程,把单篇耗时从 10 小时压到 6 小时以内;第 9~12 周,回头看前几篇,挑一篇数据最好的写续集或深化版——系列化是积累读者最快的 way,没有之一。写作这件事,前 10 篇靠纪律,之后靠惯性。三年后回头看,你会感谢今天点下「发布」的自己。

免责声明

本工具与文章内容仅用于学习测试场景,优化建议仅供参考,请勿直接用于生产环境,由此产生的风险自行承担。