Anti-Patterns in Software Blogging

Simon Willison's Weblog2026年10月7日

7.5内容质量

TL;DR · AI 摘要

软件博客写作需避免漫无边际的引言、过度正式和依赖链接，应使用个人化语言增强可读性。

按章节快速跳转。

用一张图看清主题之间的关系。

查看大纲文本（无障碍 / 无 JS 友好）

值得收藏与分享的关键句。

Beginner software bloggers suffer from a mass delusion that you have to write in a stiff, overly formal way for people to take you seriously
— 正文引述部分
⬇︎ 下载 PNG 𝕏 分享到 X
My rule of thumb is that my article should still make sense to the reader even if they don't click any links
— Lobste.rs评论引用
⬇︎ 下载 PNG 𝕏 分享到 X
With so many developers delegating their writing to AI, software blogging is becoming bland and homogenous
— 正文分析段落
⬇︎ 下载 PNG 𝕏 分享到 X

#技术写作#博客技巧#软件工程

#smallhead

由以下公司赞助：

Deepgram — Flux TTS 记住对话内容，因此你的代理在回复时表现得体。

试听演示

2026年10月7日 - 链接博客

[软件博客中的反模式](via) Michael Lynch 提供了一些极佳的写作建议。他警告要避免“漫无边际的引言”，误判读者已有的知识水平，假设读者会阅读你之前的帖子，以及过度正式的写作风格。

他还警告不要过度依赖链接作为不解释术语的借口。这一点让我很受触动！我经常这么做，但我一直怀疑几乎没人会点击这些链接。

（在 Lobste.rs 的评论中，Michael 明确指出：“我的经验法则是，即使读者不点击任何链接，我的文章仍然应该对读者有意义。”这个原则对我来说非常适用。）

关于使用自己声音这一点至关重要：

初级软件博主普遍陷入一种集体幻觉，认为必须用僵硬、过度正式的方式写作，才能被认真对待 [...] 只需要用你说话的方式写作。随着越来越多开发者将写作任务委托给 AI，软件博客正在变得乏味且同质化。读者渴望看到有个性的写作。

发布于

2026年10月7日

下午2:53