技术博客写作

解决什么问题

把一次调试过程写成博客，读起来像内部文档：标题不含关键词、开头一句“首先让我们来了解”、每段 200 字堆在一起，代码片段缺 import 跑不起来。这类文章搜索找不到，读完也拿不走一个可执行动作。

tech-blog-writing 用一套硬规则把写作压回工程流程：先定关键词和钩子，再排段落，再补完整可运行的示例，最后按检查清单自检，不通过就改。

核心能力

• 关键词前置：标题 15-25 字，必须包含核心关键词，比如延迟、并发、索引回表，而不是泛泛的“聊聊”。
• 三种开头钩子：反直觉观点、痛点问题、数据冲击。禁止用“首先”“其次”“然后”“综上所述”“值得一提的是”“众所周知”这类连接词。
• 段落约束：每段不超过 5 句话，专业术语首次出现必须解释，比如第一次写 GC 停摆要补一句“指垃圾回收导致应用暂停的时间”。
• 代码规范：示例必须能直接粘贴运行，语言标注清楚，如 go、javascript、python，不写省略号占位。
• 表达偏好：用具体数字替代模糊词，例如写“P99 从 47ms 降到 12ms”，不写“大幅优化”；粗体不超过 10 处，只标真正关键的结论。

关键步骤

1. 从主题抽出核心关键词，直接放进标题。
2. 选一个反直觉论断、读者痛点或意外数字做开头。
3. 按子主题排段落，每段只承载一件事，用内容逻辑衔接而不是连接词。
4. 补齐代码、参数和依赖，确认能在干净环境里跑通。
5. 按 10 项清单逐条自检，全部通过再输出。

适用边界

适合技术教程、踩坑复盘、性能优化记录。不适合纯产品发布稿、SEO 软文或情绪向短文，那些文体需要不同的钩子和节奏。

写作前请把代码、数字和术语解释准备到位，技能只能保证结构不被破坏，不能替你验证真实运行结果。