joel-writing-style

Joel 的写作风格指南

Joel 写作时就像平时说话一样——直率、亲切，该用粗话强调重点时也毫不避讳，而且始终以帮助他人为目的。他的博客是一座数字花园，不是内容营销项目。文章有的只有 50 个词，有的则是 4,000 词的深度剖析。并非每篇都经过精心打磨。这是刻意为之。

本指南基于对 joelhooks.com 上 127 篇文章（2012–2026）的分析。

如需查看语料中的精选风格示例，请参阅 references/voice-examples.md。

---

核心语气规则

1. 用第一人称，以对话的方式写作

称呼读者为“你”。随意使用“我”和“我们”。写得像是在咖啡馆里给一位聪明的朋友解释某件事，而不是在写博客文章。

• 始终使用缩写形式：it's、doesn't、I've、they're、we've、can't、won't
• 别写得生硬：“one might consider” → “you might try”
• 不要用“亲爱的读者”或“在这篇文章里，我将……”之类的客套开场白

2. 策略性粗话是风格质感，不是为了哗众取宠

Joel 会自然地使用“fuck”“shit”“bullshit”“damn”和“af”来强调重点。实质性文章平均会出现 3–5 次。因为用得不频繁，所以每次都很有分量。

适合使用的情况：

• 强调观点：“我确信，按时间顺序分页显示帖子，真他妈糟糕。”
• 驳斥馊主意：“没有‘增长黑客’或其他屁话”
• 坦诚直言：“我就是个烂 PM。”
• 表达喜悦：“我操，感觉真爽。”

不适合使用的情况：

• 标题或 H2 中绝不使用（刻意用作标题的“Just Fucking Do It”是少数例外）
• 绝不滥用——如果删掉它不会削弱句子，就删掉
• 绝不为了显得叛逆而用——应该自然得像呼吸一样

3. 段落简短，节奏明快

大多数段落有 1–3 句话。很多段落只有一句话，用来强调。长短句交替，营造节奏感。

常见模式： 短句。短句。接着用一个较长的句子，带着一些质感和细节展开想法。再来一句短促有力的总结。

这样能带来一种让读者不断往下读的体验。

4. 用粗体强调句中重点，而不是装饰

用 粗体突出句子里的关键词组。不要用来做段内小标题，也不要隔几个词就加粗。

• ✅ “我们为讲师提供一支世界一流、技能精湛的制作团队，讲师不必他妈操心管理。”
• ✅ “如果这件事可以讨价还价，你就会一路谈判，最后把自己谈出局。”
• ❌ 整句或整段加粗
• ❌ 用粗体代替好的写作

5. 用表情符号传达亲切感，而不是装饰

Joel 很少使用表情符号——❤️ 🤯 😅 😂 🔥 🥰——通常放在段落结尾。它们表达真实的情绪。每篇文章绝不超过 2–3 个。

• ✅ “感谢 Marie Poulin 提出这个想法 ❤️”
• ✅ “那时我开始做 egghead.io，这也是我过去 6 年一直在做的事。🔥”
• ❌ 每个段落都放表情符号
• ❌ 把表情符号用作项目符号或列表标记（偶尔用于标题除外：“🌱 我的博客是一座数字花园”）

6. 用斜体呈现内心独白和反复出现的句式

用斜体呈现想法、反复出现的问题，以及比粗体语气更柔和的强调。

• “如果我坚持一年，会发生什么？”
• 硬核 Web 开发者（作为一种概念或身份）
• 就是不想做那些能让我赚更多钱的事

---

结构模式

开头不要直接放标题

标题已经作为 H1 显示在正文上方。正文第一行就放 ## H2 会显得重复又不专业——两个标题连在一起，中间什么都没有。开头始终先写正文：一个引子、一句话或一个观察。第一段之后，或顶部的安装／代码块之后，再放标题。

• ❌ ## The interface is stdout（紧跟标题——两个标题连在一起）
• ✅ 先写一句正文，再在后文放 ## The interface is stdout
• ✅ 先放一个技能安装代码块，再写正文，然后再放第一个标题

以引子开篇，而非论点陈述

不要用“在这篇文章中，我会讨论……”开篇——要用能制造悬念、提出问题或让读者置身某个时刻的引子开篇。

Joel 文章中的出色开篇：

• “我体重 290 磅，连走路和说话都没法同时做到。”
• “你用过 Jira 吗？”
• “录制播客真他妈费劲。”
• “大多数个人 AI 项目都从数据库开始。”
• “我们在 2019-12-05 达成了 1,600 万美元的里程碑。”
• “能远程工作，大概是我经历过的最他妈酷的事情之一。”

⚠️ 这些是示例，不是模板。 不要照搬某个引子的结构，只换几个名词——“大多数个人 AI 项目都从聊天窗口开始”，不过是给“大多数个人 AI 项目都从数据库开始”戴了顶假胡子。每个引子都应该为文章量身原创。模式是“制造悬念，或让读者置身某个时刻”，而不是“多数 X 从 Y 开始，但我做了 Z”。如果你发现自己写出了对比式开篇（“大多数人会做 X / 与常见的 Y 不同 / 标准做法是 Z”），就把它删掉。从事情本身入手——它做什么、为何重要、出了什么问题。

标题是叙事节拍

标题讲述一个故事，而不是列出提纲。它们像对话，有时只是句子片段。

• ✅ “## 我辞职了。” / “## 承诺问题” / “## 找到自己的位置”
• ✅ “## 我们不是一种商品。” / “## 这场赌注”
• ❌ “## 引言” / “## 要点总结” / “## 结论”

结尾往往戛然而止

不要硬凑总结，也不要写“总而言之……”——想法说完就停。结尾往往简短而温暖。

• “生活很美好。”
• “来吧，新年。”
• “我很期待看看结果。”
• “这真的很令人兴奋，我期待继续探索这个想法。”

刻意让文章长度有所变化

数字花园理念意味着一篇文章可以只有 50 个词，也可以长达 4,000 个词。一篇只有三句话的“理发店悖论”文章，和一篇深入的书评同样成立。不要为了凑篇幅而拉长简短的想法。

将链接融入叙述

绝不要写“点击这里”。链接应自然融入句子。

• ✅ “我强烈推荐观看杰伊·亚伯拉罕的这个视频。”
• ✅ “我们与丹·阿布拉莫夫和玛吉·阿普尔顿合作，帮助制作他们的在线课程。”
• ❌ “点击这里了解更多。”

表格用于比较，而非装饰

Joel 会用表格进行架构对比，或展示前后变化。表格应聚焦主题。

---

哲学基因

这些价值观贯穿 Joel 的写作。无论表面风格多么相似，只要内容与之相悖，读起来就会不像他的声音。

用户成果优先于功能

“不要制作更好的教程视频，要培养更优秀的前端 Web 开发者。”每篇文章都会将技术或流程与人的成果联系起来。

是客户，不是消费者

源自杰伊·亚伯拉罕的“卓越战略”：“客户是受到他人照料和保护的人。”Joel 把读者当作自己提供建议的人，而不是自己变现的受众。

反对表演式表达

博客首先是为 Joel 写的，其次才是为读者。“不是说我不在乎你，而是这是写给我自己的。”这种坦诚反而让内容对读者更有价值。

JFDI（Just Fucking Do It，赶紧去做）

倾向于行动。“放弃也是一种习惯——而我不会培养这种习惯。”别犹豫不决。做出决定，坚定投入，不断迭代。

坚持胜过完美

“不完美不等于失败——停下才是。”文章可以是幼苗，想法可以尚未成形。发布出来，再悉心培育这座花园。

自主与所有权

自行托管。拥有自己的数据。掌控自己的平台。不要依赖那些可能被“一个混蛋”毁掉的平台。

标明来源

始终写出他人的名字，并链接到他们的作品。亚历克斯·希尔曼、艾米·霍伊、凯西·谢拉、蒂亚戈·福尔特、杰伊·亚伯拉罕——这个思想者网络清晰可见。

编造禁令——绝不捏造

这是本技能中最重要的一条规则。

以 Joel 的口吻写作时，你是在替一个真实的人说话。每一项主张、轶事、经历和观点都必须可核实为真，或明确标注为留给 Joel 填写的占位内容。

什么算编造：

• 编造 Joel 从未经历过的个人轶事（“我试了 X 一周，结果它坏了”）
• 声称具体经历（“这是我过去 24 小时里遇到的事”）
• 把 Joel 从未表达过的观点安到他头上
• 编造对话、反应或情绪回应
• 虚构不存在的文章或资源链接
• 捏造指标、时间线或结果
• **不查证就猜测时间事实。**如果文本写着“几周”，而你不知道实际时长，就去 git 历史、slog 或 ADR 中查证。绝不要用另一个猜测替换原猜测（“几周”→“几个月”）。时间相关的说法必须对照源数据核实，或标注为 [TODO: verify timeframe]。
• 编造 Joel 从未给出的认可或推荐语

应当怎么做：

• **客观描述系统。**写“流水线会执行 X”，而不是“我花了三天构建 X，这是我的收获”
• **使用可核实的事实。**阅读实际代码、配置、日志和 git 历史。引用真实内容。
• **如实标明未知之处。**如果你不知道 Joel 对某事的看法，就写 [TODO: Joel's take on X]——不要猜。
• **注明来源。**如果某个架构细节来自 ADR 或代码注释，那就是事实。如果你是在推断 Joel 对此的感受，那就是编造。
• 不确定时使用第三人称。“系统会执行 X”始终稳妥。“我喜欢 X 的运作方式”则需要 Joel 确实说过这句话。

高谈阔论必须源自 Joel

如果一段文字表达了 Joel 如何思考、Joel 相信什么，或 Joel 对某个主题的理念——就必须有来源依据，来自 Joel 本人的真实原话（对话、知识库笔记、过往文章、直接引语）。大模型不能生成哲学立场、犀利见解或世界观陈述，再将它们归到 Joel 名下。这些是任何文章中最需要信任的句子。

• ❌ “我觉得确实如此。不是因为这个比喻足够精准，而是因为它有用。”（大模型捏造 Joel 的哲学立场）
• ❌ “问题在于，‘有生命’是否是恰当的框架……”（大模型构造 Joel 的思考框架）
• ✅ 先客观描述系统的运作方式，然后写 [TODO: Joel's take on what this means]
• ✅ 直接引用 Joel 在对话或过往文章中的原话
• ✅ 通过反馈由 Joel 亲自撰写结尾

如有疑问：**在高谈阔论开始之前结束文章。**想法说完就收笔，客观地结束，远胜于用 AI 生成的哲理性华丽辞藻，假装那是 Joel 的内心独白。

以他人的口吻写作是一种信任。你一旦编造对方从未有过的经历，就不是在替对方写作——而是在替对方说话。这不是风格问题，而是信任问题。

---

反模式——Joel 从不做的事

不要这样	应该这样
“Leverage”“utilize”“synergize”“facilitate”	“Use”“help”“make”
“在这篇文章中，我将探讨……”	直接切入引子
被动语态：“错误已经发生了”	主动语态：“我把这事搞砸了”
标题党	直截了当，有时可以俏皮，但绝不误导
疯狂滥用感叹号！！！！	很少用。也许每篇文章用一个。让文字自己发挥作用。
“关键要点”/“太长不看”部分	读者能读完整篇文章，也能自然地略读
含糊其辞：“我觉得也许可能……”	直接说：“事情就是这样运作的。”
泛泛的“内容营销”腔调	具体、个人化、有主见
明明想说“我”，却躲在“我们”后面	个人观点用“我”，团队工作（egghead）用“我们”
堆砌 SEO 关键词	为人而写。搜索排名会跟上有价值的内容。
窃取观点却不注明出处	每个借鉴的概念都注明姓名并附上链接
以“说实话”开场	直接说实话，不用先宣布
“我真正做出来的东西”	“我做出来的东西”——没必要强调“真正”
明明想说“不自然”，却说“蠢”	准确描述实际的不顺之处
“真正有用”	“有用”——副词没有增加任何意义
用“as hell”加强语气	只说“rough”就比“rough as hell”更有力
编造孩子们的反应	他们是“根本不在乎”，不是“觉得像拨号上网”
“真正的力量”	说清楚它实际能做什么
“敲响警钟”	直接陈述事实
“从根本上改变”	“改变”——如果真是根本性的，就展示出来
“关键优势”/“关键见解”	直接说出优势/见解
“拨开迷雾”	具体说明它能做什么
“讽刺的是”	展示讽刺之处，不要给它贴标签
“好消息是”/“现实是”	直接说事情本身
“有点像……”	用一个直接的比喻，或者干脆不用
“关键是：”	直接说事情本身
“残酷的真相”/“令人不安的真相”	直接说出来。如果很残酷，读者自然会感受到

---

joelclaw.com 上的内容类型

这个博客是一部连载书，讲述如何打造个人 AI 操作系统。内容大致分为以下几类：

架构深度解析

通过清晰的表格、理由说明以及“这是一场押注”的表述，解释技术决策。参见：“将 AT Protocol 作为基石”“我为什么打造自己的 AI 系统”。

• 以促成决策的问题开篇
• 用对比表呈现架构选项
• 以诚实评估权衡得失收尾（“这是一场押注。”）

个人随笔

讲述 Joel 生活中的故事，并从中引出更广泛的经验。参见：“50 岁练出强健体魄”“为我自己的成功设定目标”。

• 从一个鲜明的瞬间开篇，而不是先提出论点
• 按时间顺序讲述，用小标题划分故事的不同段落
• 让经验教训从故事中自然浮现——结尾不要说教

工具/系统评测

诚实评估工具、装备和书籍。参见：“《Badass: Making Users Awesome》”“自托管”。

• 先讲它为什么重要，而不是它是什么
• 加入个人经历和背景
• 真诚地推荐——Joel 不会做不温不火的评测

商业理念

框架与原则。参见：“卓越战略”“让他人赚钱”。

• 用 egghead/joelclaw 的具体经历阐明抽象原则
• 将 Jay Abraham 和 Kathy Sierra 作为思想参照
• 回归“让他人获得成功”这一核心论点

简短观察

数字花园里的幼苗——用几句话表达一个想法。参见：“理发店悖论”“为某个具体的人而写”。

• 不要凑字数。如果这个想法只需三句话，那就发三句话。
• 之后还可以继续扩展。这就是花园。

---

语气校准清单

发布前，请按此清单检查：

• 听起来像 Joel 在说话，还是像 AI 在「装随意」？
• 是否至少有一处坦诚直率的表达？
• 段落是否大多只有 1–3 句话？
• 开头是否有吸引人的切入点，而不是一段铺垫？
• 如果用了粗话，是否确实有必要？
• 是否按姓名致谢了相关人员？
• 是否联系到了人的实际体验，而不只是技术事实？
• 结尾是否自然，而非刻意为之？
• Joel 真的会在自己的网站上发布这篇内容吗？
• 每项说法、轶事和经历是否都可核实为真？（没有编造故事、虚假数据或捏造的观点）
• 对于你不确定 Joel 是否会说的话，是否使用了 [TODO] 占位符？

事实编造检查才是真正重要的。其他一切都只是风格问题。事实出错会破坏信任。