软件博客中的反模式
软件和开发者博客越来越常因“迂回的开头”、把最重要内容埋得太深、过多把链接当作家庭作业，以及默认读者“除了这一个点外什么都知道”的教程而受到批评。评论者认为，好的技术写作应当尽早呈现核心观点，清楚说明前置条件，尊重读者时间，并明确作者的专业程度——同时在合适的受众面前仍可保留个性与叙事性。讨论还探及大型语言模型如何正在挤压 Stack Overflow 式问答，这使得人类撰写的帖子更需要提供真正的洞见、上下文和最新指导，而不是 AI 式的空泛内容。
迂回的开头与讲故事
- 许多评论者不喜欢技术文章里冗长、充满悬念的开头；他们希望尽早看到核心观点和价值主张（“不要把最重要的内容埋得太深”）。
- 也有人认为，讲故事有助于吸引读者并帮助理解，尤其是在读者处于“学习 + 娱乐”模式，而不是以排错为目的时。
- 有几个人区分了不同形式：故障排查或叙事型文章可以承载更多故事；教程、参考文档和新闻则应该直截了当。
- 还有人担心“每个句子都只为了让读者继续读下去”会变成点击诱饵、互动诱饵，或者“AI 垃圾”，除非它确实建立在真实价值之上。
受众、目的与风格
- 一个反复出现的主题是：一切都取决于上下文。好的结构取决于受众（HN 风格的 SWE、博士、普通学习者、爱好者）以及写作意图（快速教学、引发思考、娱乐）。
- 有些人偏好中性、平实的文风；另一些人喜欢强烈的个人风格。无论过于随意还是过于正式，都可能让人反感，具体取决于个人口味。
- 关于写作的建议被视为指导，而不是法则。多人强调：“对所有规则都要适度保留。”
初学者 vs 专家口吻与权威感
- 一个主要的反模式是：“我做过一次，所以我就是专家。”当作者把周末做的试验写成权威性的最佳实践时，读者会提出异议。
- 很多人仍然希望初学者写作，但要清楚地把文章定位为笔记、实验，或是部分理解的记录。
- 更好的做法是：明确分享不确定性和未解问题，而不是从单次经验中过度泛化。
链接、前置条件与维护
- 过度依赖链接而不做摘要，会把文章变成“家庭作业森林”。人们更喜欢总结链接内容，或引用关键部分。
- 一个关键失败模式是假设“读者除了一个点之外，知道我知道的一切”。读者希望看到与熟悉工具的比较，以及清晰的动机说明。
- 过时的教程（例如针对旧版框架）是常见的挫败来源；建议的修复方式包括更新，或明确标注内容已过时。
LLM、Stack Overflow 与博客的价值
- 有人说，LLM 在很大程度上已经取代了 Stack Overflow 以及许多开发博客的快速问答功能；也有人追问，如果论坛和博客衰落，LLM 将从哪里获得新鲜、高质量的知识。
- 也有人依然认为博客很有价值：它们提供更深的上下文、个人视角，也是写作者的思考工具。
- 人们对 LLM 生成的帖子明显缺乏信任，因为它们常被认为冗长、泛泛而谈，而且往往缺少实质内容。
个人博客 vs 产品化内容
- 一种观点认为：博客本来就是个人化的；如果作者并不追求增长或读者规模，就没有所谓的“反模式”。
- 另一种观点认为：即便是个人网站，糟糕的写作模式依然存在，尤其当文章被广泛传播并影响社区实践时。