前言
工程界有句调侃："会写代码的千千万，会写字的万里挑一。"
事实是：能写好代码又能让别人看懂你写什么的人——比只会写代码的人平均收入高出 30-50%（Stack Overflow Developer Survey 2024 数据，写技术博客的开发者薪资分布确实显著高）。
这篇文章不讲怎么写爆款，讲怎么把"写"这件事变成职业复利。
一、为什么技术写作能换钱
讲清楚一件事的价值，可能比你能讲清楚 5 件事大得多。技术写作能带给你：
简历加成：面试官看过你的 3 篇博客，比"精通 Kotlin"五个字有用。
品牌效应：客户/合作方认识你，不是从公司名而是从你名字。
求职溢价：发过 50 篇高质量博客的人，跳槽时拿 offer 概率远高于普通人。
副业机会：付费课程、技术咨询、技术书约稿，都是水到渠成。
但如果"是为了赚钱去写"，坚持不了 6 个月。一开始还是把它当成"自我投资"。
二、写作平台的选择
国内几个主流平台特点：
建议：中文为主战场用掘金 + 知乎 + 个人博客；要做国际化或英文产品，写 dev.to / Medium / Hashnode。
不建议把内容分散同步到 5+ 平台——你会累到放弃。主战场 2 个，剩余 1-2 个做备份同步就行。
三、选题的来源
新手最大的卡点是"我不知道写什么"。选题从你每天的工作里抓：
Bug 排查过程——"我修了 3 天的一个 OOM Bug"，把整个排查过程写下来。
架构决策的复盘——"我们为什么放弃 MVI 改回 MVVM"。
踩坑记录——"Compose 在 Android 14 上的 5 个坑"。
新库上手——"从 0 到 1 用 Retrofit + Flow 上生产"。
大型项目心得——"我们把 12 万行 App 的构建时间砍半"。
选题的 80/20：80% 的好选题来自你自己的项目。
四、怎么写一篇"有阅读量"的文章
4.1 标题不是 SEO，是承诺
很多人标题写成"Android Jetpack Compose 学习"。没人搜索"学习"。改成可被搜索的具体承诺：
❌ "Android LiveData 解析"
✅ "LiveData 重复收到同一个值？我踩过的 4 个坑与根因"
4.2 开头 30 秒留住人
读者在第 30 秒决定要不要继续：
## 前言
三个月前我有个 IM App 推送消息偶发延迟最高 8 秒。
排查了一周，发现根因在厂商通道的"心跳绑定"。
...
而不是"LiveData 是一个响应式数据持有者"——这种百度一下就有，没人看你的。
4.3 节奏要快
每 200-300 字一个小标题；
代码片段不超过 30 行一次；
关键概念用比喻，比如"协程像快递员"；
结尾必给一句"接下来学什么"。
4.4 配图 / 配图替代品
流程图、时序图、对比表是关键。我用 Mermaid 写流程图，文字编辑器里直接渲染：
ServerAppUserServerAppUser点击登录POST /login401 token 过期弹"重新登录"对话框
4.5 结尾的钩子
> 系列下一篇：...
> 系列目录：[100 篇进阶笔记](/)
> 如果本文对你有帮助，点个在看鼓励一下 ✨
不写钩子的文章永远在阅读量上不去——读者看完即走，没有理由追你。
五、写作频率与门槛
常见错误：过度追求日更。
新人不建议一周一篇以上的频率。理由：
频率高质量一定下降；
没东西硬写，写出来就是水文；
写作变成痛苦的负担，写两周就放弃。
建议节奏：每两周一到两篇，每篇 1500-3000 字。
写一篇真正值得发表的文章需要 4-8 小时（包括调研、写作、配图）。断更不可怕，质量胜过数量。
六、获得第一批读者
新人的头 20 篇几乎没人看，但必须写下去。把"无人看"也当作练习。
6.1 主动推送
写完发到公司技术群（不打扰同事，先发 5 分钟预告）；
发到你常逛的 Slack/Discord/Telegram 群；
给朋友圈技术相关的人私聊推荐；
主动评论别人的文章并留下链接（不要刷，要真的有用）。
6.2 平台加持
掘金：申请"掘金优秀创作者"标签，有流量倾斜；
知乎：写好第 5 篇后申请"科技领域"创作标识；
公众号：找粉丝 500-2000 的技术博主互推。
6.3 让"找不到的工作"找上你
坚持写一年，会有猎头主动找到你、出版编辑约书、技术大会邀请你做分享。这些都不会从天而降——是平台 + 沉淀 + 时间。
七、个人品牌 = 长期复利
我身边做技术写作坚持 5 年以上的同事：
跳槽涨薪 50-100% 常见；
出过书的同事已经 6 位数版税；
几个主业 + 副业结合的同事已经创业。
但这一切的前提是：先坚持写 50 篇。
第 1-30 篇——基本没人看，纯属练习； 第 31-50 篇——开始有少量阅读和反馈； 第 51-100 篇——读者主动找你问问题、问合作。
八、写给"我文笔不好"的人
技术写作不需要文笔。需要的三个能力：
结构感——每段讲一件事，段与段之间有连接；
具体感——用数字、代码、截图代替抽象描述；
诚实感——错了就承认，不懂就说不懂。
这三个能力都不需要天赋。
小结
技术写作是少数几个"业余时间做、不影响工作、能换长期复利"的事。下一篇文章我们换个视角：AI 时代下，Android 工程师的技能树该怎么重构——这是这一系列"以工程师为本"的最后一篇主题文章，下一篇（第 100 篇）会做整个 100 篇的总览与成长地图。
参考阅读
《技术写作指南》— Google 开发者文档
《Made to Stick》— Chip & Dan Heath
Dan Luu 技术博客（danluu.com）—— 工程师写作的标杆