《软件博客反模式》：HN 热议 Lynch 的技术写作避坑清单
Michael Lynch 在 Refactoring English 列出技术博客写作的 6 大反模式：东拉西扯的开头、错误的读者假设、链接依赖、续集式开场、过度正式、HTML 基础翻车。访谈结合 HN 评论区 117 条讨论，聊故事与效率之争、AI 写作时代的个性稀缺，以及 2026 年还值不值得开博客。
这周 HN 首页出现了一篇有点"套娃"的文章：以教程序员写英文出名的博主 Michael Lynch，在他的 Refactoring English 上发表了《Anti-Patterns in Software Blogging》，把技术博客写作最常见的错误编成了一份反模式清单。一共六条：漫无边际的开头（外加一条"前言也算东拉西扯"）、对读者知识的错误假设、过度依赖链接、"续集注入式"开场、过度正式的行文、在 HTML 渲染基础上翻车（手机端溢出、难读的字体配色）。帖子拿下 200 多分、117 条评论，评论区本身开成了一场写作研讨会。我请来陈默——写了十年技术博客的前开发者布道师，现在是自由技术写作者，天天跟"怎么写人话"打交道。我们聊了聊这份清单、评论区的几场争论，以及 AI 写作时代里，博客还剩什么。
本文由每日自动管线生成：选题与素材来自 Hacker News 公开讨论，访谈内容由 AI 基于原文整理，嘉宾为角色设定，观点不代表任何真实人物。
小听： 默哥，先从清单第一条开刀："漫无边际的开头"。Lynch 说这是最常见的错误——读者读了好几段还不知道作者想说什么。评论区里有人分享自己的做法：把结论直接扔在第一段，让读者自己决定值不值得花时间。你写了十年博客，认这条吗？
陈默： 认，而且这是唯一一条我愿意判"死刑"的。写博客的人有个错觉：读者是冲着你这个人来的，愿意陪你从三年前的往事讲起。真相是读者手里开着一万个标签页，你跟他们之间只有三句话的缘分。Lynch 的建议很实在：标题加前三句，必须回答两个问题——这是写给像我这样的人的吗？我读完能得到什么？
小听： 评论区有个说法很损：最伤人的不是写得烂，是"读到一半才意识到自己被浪费了"。还有人搬出本科导师的告诫——论文和演示不是侦探小说，别把结论藏到最后吊胃口。
陈默： 侦探小说这个比喻一针见血。悬念是娱乐产品的卖点，技术文章卖的是信息密度。还有条评论说得好：现在 AI 最有用的地方就是把臃肿文本压缩成精华——反过来说，如果你的文章能被压缩掉一半还不损失信息，那一半本来就不该存在。不过我也要替"开头"说句公道话：Lynch 自己都承认，前言、副标题、配图、名人名言这些都会消耗读者的注意力预算，不是不能放，是每一件都要花钱。
开头太长，读者走不到那扇门。
小听： 第二场争论最有火药味：有人坚持"教育不是讲故事，不该按故事结构写"，学东西就是要高效获取信息，把悬念留到最后是有害的。Lynch 本人下场回复，承认自己也被困扰——Paul Graham 和 Joel Spolsky 的文章也经常不直奔主题，但人家有名所以没人计较。
陈默： 这场我站中间派，也就是评论区里反驳得最漂亮的一条：人类天生爱听故事，故事能维持注意力、能装下复杂概念。问题不在"讲不讲故事"，在"故事是不是手段"。Lynch 的逻辑是：故事可以是教育的工具，但不能是目的。另一位评论者分得更细：抓 bug 历险记就适合讲故事，API 参考文档不需要一滴故事。类型决定手法，这话对中文技术社区尤其适用——我们太多人把"教程"写成了"游记"，又把"思考"写成了"说明书"。
小听： 说到类型，清单里"过度依赖链接"那条也被评论区挑战了：有人说他就喜欢链向更好的外部资料，而不是自己重复造轮子；也有人说这些"该做不该做"高度依赖场景，个人博客大可打折执行。甚至有人直接掀桌：博客本质是个人日记，想写啥写啥，不存在反模式。
陈默： 掀桌那位立刻被反驳了：这好比说不存在烂文章，因为人想写啥写啥。反模式这个词本来就是从软件工程借来的——它描述的是"看起来合理、实则通向坏结果"的惯用法，不是法律。但我最欣赏的是另一条评论的升维打击：最大的反模式恰恰是"不为目标读者写作"——Lynch 的清单默认读者是典型 HN 式工程师，你照搬它去讨好完全不同的读者，那才是真正的错。还有人补充：博士和研究员读者挖得更深、对论证更挑剔，策略得跟着受众走。
小听： 清单里我最喜欢的是"续集注入 bug"这个名字：很多博客开头就是"在上一 part 里我们学了……"，默认读者读过上一篇。Lynch 说绝大多数读者没读过，你得把相关的东西总结出来，而不是逼人回去补课。
陈默： 这个名字起得太程序员了，我怀疑就是为了让 HN 读者会心一笑。它的本质是"默认上下文"——跟第二条反模式"读者除了这个都知道"是一体两面：一个高估了读者的记忆，一个高估了读者的知识。评论区有人把"知识的诅咒"称为写教程最难的一关：作者永远不知道哪一步对新手是悬崖。Lynch 给的方法很笨但有效：想象一个真实存在的朋友，列出他认识和不认识的术语清单，写完对照着改。
小听： 聊聊 AI。评论区有个热门观察：有些星期感觉看到的大多数软件博客都是 LLM 写的，特征是"用三倍于必要的字数说事"，毫无实质。还有人说得更狠：这类文字最让人恼火的不是错，而是形式正确、背后却没有任何真实的心智。
陈默： 这话说的就是"过度正式"那条的 2026 年版本。Lynch 写那条时是说：别写公文腔，读者可能穿着睡衣就着麦片看你的文章，"像说话一样写"。现在 AI 把公文腔发扬光大了——永远正确的结构、永远积极的语气、永远三倍的字数。有条评论建议给技术博客加"AI 生成内容"标签，像食品成分标签一样，我觉得早晚的事。另一位说他现在把"疑似 LLM 写作"当负面信号：那可能意味着作者没花心思。
当所有人写得都一样，"像人一样写"就成了稀缺品。
小听： 最妙的回旋镖来了：有人指出，作者把这篇文章发到网上，某种程度上已经是在"教 LLM 这些反模式"了。评论区还贡献了新的反模式：教程因版本更新失效却无人维护、文章不写发布日期、文末再来一段重复总结。还有个自嘲的：一位博主承认自己的整个博客就是反模式合集——万字长文、超长前言、1:1 的正文脚注比，手机上排版错乱也懒得修，理由是"我只为自己写"。
陈默： Lynch 的追问很妙：真只为自己写，为什么还提交到 HN？这句话值得所有博主贴在显示器上。"为自己写"和"发表"是两回事，前者是日记，后者是产品。至于"教 LLM 反模式"这个回旋镖，我倒觉得是好事——以毒攻毒，让模型也学会别写八股文。关于维护旧文那条，评论区说得对：技术博客的保质期是按版本算的，不写日期的文章就是没有生产日期的食品。
小听： 最后一个问题来自评论区：2026 年了，还值得开博客吗？有人回：价值在于思考本身，读者只是附带；也有人说写作的最大受益者其实是作者自己。
陈默： 我拿这个当结尾标准答案。Lynch 整份清单归纳起来就一句话：尊重读者的时间和注意力。而评论区补上了另一半：尊重你自己的思考。这份清单是英文世界写的，但每一条都能直接空投到中文技术社区——东拉西扯的开头、默认读者啥都懂、满篇"详见链接"、公文腔翻译体，我们一样没少。AI 时代反而让这件事更值钱：当机器能量产"看起来正确"的文字时，"有人味"的写作就成了硬通货。开博客吧，但别写侦探小说。
小听： 总结一下今天的访谈：开头三句话交代价值，故事是手段不是目的，为具体的读者写作而不是为"读者"写作，像说话一样写，以及——给文章写上日期。原始讨论和原文见参考链接。