2026 年 10 月 7 日,独立技术博主 Michael Lynch 在其站点 Refactoring English 发表了题为《软件博客反模式》(Anti-Patterns in Software Blogging)的长文,对技术社区长期奉为圭臬的写作习惯提出尖锐批评。随后,Django 联合创始人、资深博主 Simon Willison 公开呼应这一观点,并承认自己长期存在用超链接替代术语解释的坏习惯。

这篇讨论之所以在技术社区激起回响,核心原因在于生成式大模型正将原本鲜活的技术博客推向平淡同质化。Lynch 与 Willison 的反思揭示了一个残酷现实:初学者误以为死板的行文才显专业,资深开发者则习惯用外链向读者转嫁认知成本;当越来越多工程师开始依赖 AI 生成博文,这种剥离了个人腔调与清晰逻辑的内容,正在迅速透支技术博客赖以生存的信任资产。

形式主义盛行:漫长开场与伪装成专业的阅读枷锁

在许多开发者的潜意识里,一篇严肃的技术博文必须效仿学术论文,先铺陈冗长的背景叙事或挂上名人名言,才算进入正题。Lynch 直截了当地将这种做法定性为漫长开场白反模式。他给出的修正准则极为苛刻:写作者必须利用标题和前三句话,彻底交代清楚文章的目标受众以及读者能获得的具体收益,而不是用个人履历或空洞的引言拖延价值交付。

更具隐蔽性的坏习惯是用超链接推卸解释责任。技术文章里经常密布着通往外部文档的蓝色下划线,写作者自以为提供了严谨参考,但 Simon Willison 坦言,自己明知极少有人会去点击,却依然用链接当借口跳过核心概念的阐述。Lynch 在 Lobste.rs 社区的讨论中给出了底线标准:正文必须做到自包含,即便读者一个链接都不点,整篇文章的逻辑推演也必须完全成立;外链只能充当可选的深度拓展,绝不能变成读者理解本文的必读作业。

技术博客两种写作范式的认知成本对照 转嫁负担:依赖外链与形式主义 • 漫长开场白延后核心结论交付 • 强行假设读者读过既往系列篇章 • 频繁跳出查阅术语打断沉浸阅读 后果:读者认知超载,单篇跳出率飙升 内容闭环:自包含与具象化叙事 • 标题与前三句锁定受众与直接收益 • 把读者想象为“某个具体朋友”对齐术语 • 关键概念就地解释,外链仅作延伸选读 收益:完整闭环理解,建立个人专业信誉

为了精准校准读者的认知基准,Lynch 建议写作者在动笔时把读者具象化为过去的自己或某位具体朋友,提前列出这位读者已知与未知的术语清单。这种自律不仅能避免自说自话,也能避免要求读者预先阅读前序篇章等连载特有的阅读门槛。

范式冲突:个人博客的自由度与官方文档的规训

技术写作领域长久以来存在一套权威指南。Google 开发者文档风格指南(Google Developer Documentation Style Guide)曾塑造了数百万技术人员的行文方式。然而,Lynch 所倡导的博客原则,与大厂的规范文档存在根本性的路线分歧。

博客不是去个性化的产品手册,它必须能让人读出说话者的体温。

Google 文档指南建议将语调定位为理解开发者意图的博学朋友,在术语替换上坚持使用精准、熟悉的语言,并明确允许将特定概念链接至权威定义以保持篇幅精炼。在语言风格上,Google 虽然认可对话式语调,却明确警告不得完全按说话方式写作,目的是剔除地域俚语和冗余絮叨,保证全球工程师能以最低摩擦获取统一含义。

Google 官方规范文档 vs 个人独立博客的底层逻辑分歧 术语定义策略 Google 规范:允许链接权威定义保持篇幅精炼 Lynch 主张:必须在页面内部完成解释,杜绝外部跳转依赖 语言口吻尺度 Google 规范:警告完全按口语写作,规避俚语与冗余表达 Lynch 主张:像平时说话一样写,彻底撕掉虚伪的严肃面具 最终交付目标 Google 规范:去个性化、全球无歧义的标准化工程参考 Lynch 主张:带有鲜明主观判断、强辨识度的个人工程信誉

但个人博客的成立逻辑截然相反。开发者写作不是为了产出一份无可挑剔的企业级 SDK 说明书,而是为了沉淀真实思考、建立专业壁垒。Lynch 主张彻底撕掉假装严肃的面具,强调像平时说话一样写。Google 追求的是去个性化的机器可读性,而个人博客的杀手锏恰恰是那个坐在屏幕背后、有着明确喜恶和真实踩坑经历的人。


AI 稀释内容密度,真实人格成为最终溢价

在生成式 AI 渗透进各行各业的 2026 年,大模型已经能够秒级产出一段结构工整、术语无误但索然无味的技术解释。随着大量开发者将博文撰写工作委托给 AI,技术社区正被流水线套话淹没。这种内容语法正确却面目模糊,缺乏工程一线的血肉感。

Lynch 在长文中列举了多位具备鲜明个性化文风的行业先驱:Joel Spolsky 充满幽默感的工程洞察、Kathy Sierra 颠覆常理的认知引导、Terence Eden 敏锐的技术挑刺,以及 Raymond Chen 几十年如一日抽丝剥茧的 Windows 内部机制拆解。这些长盛不衰的技术专栏从来不靠套路模板,读者正是被其独特的说话方式和思考切角所吸引。

除了文字本身,反模式还广泛存在于工程体验细节中。Lynch 提醒,许多博客充斥着未经适配的移动端排版和低对比度文本,直接赶走了移动端读者。写作不仅是思考的输出,更是产品级的交付。

  • 建议.将 AI 限制在语法纠错与结构整理层面,坚持由本人写出核心解释与口语化判断。
  • 风险.继续依赖大模型代笔与外链堆砌,技术博客的阅读留存率将迅速归零,并最终失去个人品牌的可信度。

当工业级标准文档由大厂工程师和语言模型联合统治时,独立技术博主的唯一出路,就是重新找回自己的声音。