跳到正文
Simon Willison·· 10 天前AI 评分8

Michael Lynch 谈软件博客写作的反模式

Anti-Patterns in Software Blogging

AI 导读

Michael Lynch 撰文列举软件博客写作的常见反模式,包括冗长开场、误判读者已有知识、假设读者读过旧文、过度正式,以及用链接代替术语解释。他建议文章即使读者不点任何链接也应读得通,并用自己的口吻写作。在开发者纷纷把写作交给 AI 的当下,软件博客正变得平淡同质,读者渴望有个人风格的文字。

正文 · AI 翻译

2026年10月7日 - 链接博客

软件博客写作中的反模式(via)来自 Michael Lynch 的一些出色写作建议。Michael 警告不要“漫无边际的开头”、误判读者已有的知识、假设他们会读过你之前的文章,以及过度正式。

他还警告不要过度依赖链接,以此作为不解释术语的借口。这一条扎心了!我一直都这么做,但我总隐隐怀疑几乎没有人会去点那些链接。

(在一条 Lobste.rs 评论中,Michael 澄清说:“我的经验法则是,即使读者不点任何链接,我的文章也应该仍然读得通。”这对我来说可行。)

关于用自己的声音写作这一点至关重要:

初学软件博客的人有一种集体错觉,认为你必须用生硬、过度正式的方式写作,别人才会认真对待你 [...]

就按你说话的方式去写。

随着如此多的开发者把写作交给 AI,软件博客正变得平淡而千篇一律。读者渴望有个人特色的文字。

来源:Simon Willison · simonwillison.net