技术博客写作方法论：如何把一个知识点写成 3000 字

TL;DR

把 500 字的知识点写成 3000 字的技术文章，核心是用四个维度延伸：背景重构、问题演化、解决方案对比、高阶权衡。

写作不是输出，是二次创作

写完 30 多篇技术文章后，写作通过写来加深理解。

第一步：选题筛选

1. 这是你踩过坑吗？→ 真实踩坑经验 > 概念搬运
2. 这个问题有令人恍然大悟非直觉解决方案吗？→ 有则故事性强
3. 能否用 50 个字说清楚？→ 说不出说明你没真正理解

选题类型

类型	字数	适合什么
Tutorial	2000-3000	有明确步骤操作指南
Deep Dive	3000-5000	一个技术点本质分析
Postmortem	1500-3000	事故复盘、踩坑记录
Benchmark	2000-4000	技术选型对比分析
Architecture	3000-6000	系统方案设计说明

第二步：构建文章骨架

1. TL;DR — 问题 + 核心结论
2. 前提 / 背景 — 设计上下文 + 前置知识
3. 核心内容 — 3-5 个步骤，每步含代码/配置 -> 解释 -> 输出
4. Trade-offs — 表格对比各方案优缺点
5. 写在 — 总结 + 场景选择建议
6. 延伸阅读（可选）

第三步：用代码和配置来填充内容

每 300-500 字正文配 1 个代码或配置示例。太少像论文，太多像 API 文档。

第四步：用对比和决策来提升深度

每个方案最大缺点才是最有价值部分：

方案	最大优点	最大缺点
Pagefind	零配置速度快	中文分词不精确
Lunr.js	高度可定制	索引体积大

第五步：标题和开场

好的标题公式：{动作} + {目标} + {承诺}。示例：给 Astro 博客添加评论系统。

高阶技法

1. 用真实时间线增加可信度
2. 在文章末尾留下行动入口
3. 用 Trade-offs 代替优缺点 — 更诚实，更专业
4. 控制语气 — 不要用很简单众所周知

写作流程

选题（5min）-> 列结构（10min）-> 写代码/配置（20min）-> 写正文（40min）-> 补充对比表格（10min）-> 润色（15min）。总耗时约 100 分钟。

写在

写技术博客最大收获不是读者，是自己。开始写吧。