写实的写作·把内容写充实
Writing With Substance: A Coder’s Guide to Nonfiction
开篇寄语
你点开这个文件，大概是因为你遇到了这样的问题——
你写了一篇文章，或者一份技术文档，或者一篇博客，自己读了一遍，觉得”嗯，逻辑通顺，没什么大错”。但读完，你说不出自己”学到了什么”。发给同事看，同事读完说”哦”，没有”哦原来是这样”。你心里清楚，这篇东西失败了，但你不知道怎么改。
或者你打开一个空白文档，光标闪了半小时，写了 200 字，删了 100 字，再写 50 字，再删了。卡住了。不是不知道要写什么，是不知道怎么把”想到的”变成”写下来的”。
又或者你读别人的文章，读完觉得”这个人真会写”，但你自己写的时候，那种”会写”的感觉怎么也调不出来。你以为是修辞手法不够，是成语不够多，是句式不够漂亮。但你背了一堆成语、对仗、排比，写出来的东西反而更难看了。
这些情况的根上，都不是”文笔不行”。
是”内容没写充实”。
什么是”充实”？不是形容词堆得多，不是排比用得巧，不是成语用得对。充实是这一件事：
读者读完之后，比读之前多知道了一些东西。
就这么简单。但这条标准，能筛掉市面上 90% 的”看起来漂亮”的文章。你拿这条标准去量，会发现很多公众号爆款读完啥也记不住，很多技术文档读完解决不了问题，很多年终总结读完不知所云。它们都很长，都很努力，但读完读者没”多知道”什么。
这本教程要做的，就是把这套标准背后的心法、技法、案例、练习，一章一章地讲清楚。讲完之后，你应该能做到一件事：判断一篇文章 / 一份文档”充不充实”，并且知道怎么让自己写的下一份，变得充实。
最后说一句可能让你不舒服的话。
这本教程读起来不会轻松。它要求你每看一章就停下来想一想、动笔改一改、承认自己之前的某个写法是不充实的。如果你只想躺在床上一页页翻过去，那这本书对你没用，现在关掉还来得及。
如果你愿意做那些练习，二十六章之后，你会获得一样东西：读者读完你写的东西，会觉得”哦原来是这样”，而不是”哦”。
那时候你写的是文档、是博客、是教程、是答辩稿、是给同事的方案说明、是写给自己看的反思，都不重要——重要的是你写出来的每一个字，都在让读者”多知道一些”。
开始吧。
使用说明
这本教程二十六章，加这篇总论与导读。每一章八千到一万字，全都读下来是个不小的时间投入。所以先说清楚怎么用，别浪费你的时间。
每章长什么样
先说结构，你翻到任意一章，看到的都是同一套东西：
开篇是一个具体的场景。 不是一个定义。可能是一篇你写到一半卡住的文档，可能是你同事一段”看起来漂亮但读完没收获”的文字，可能是你在群里发了一段技术分析但没人回复的尴尬。场景先来，问题从场景里长出来。
然后是追问。 我会不断问”为什么""如果换一下会怎样""你这个写法凭什么成立”。有些问题我会替你答，有些我不答，留到思考题里。你最好在看答案之前自己先想三十秒——想不出来也比直接看答案强，因为你想错的那个方向，恰好暴露了你现在的写作模型。
然后是原理。 原理有来历——认知科学的、语言学的、传播学的、或者历史的。我不满足于告诉你”要这样”，我要告诉你”凭什么必须这样”。凭什么的部分，是你以后能自己推导出新技法的地方。比如”为什么一段只讲一件事”这件事，背后是工作记忆容量有限的认知规律；知道了这个，你就不是背一条规则，而是懂了一条规则为什么对。
然后是反例。 我会专门写”这个做法看起来很合理，其实是错的，以及它为什么诱人”。这部分别跳过。知道错在哪，比知道对的答案更能防止你下次犯同样的错。写作这个领域里，诱惑极多——每一种”看起来漂亮”的写法，背后都藏着一个陷阱。
然后是「心法」。 这是每章最重要的小节，也是最容易被人跳过的。技巧讲”怎么做”，心法讲”什么时候不该这么做”。如果说这本教程有什么别处买不到的东西，就在这些小节里。
然后是思考题、参考答案、动手练习。 思考题不是填空题，参考答案本身就是学习材料，动辄三五百字。动手练习每道题都带自评标准——我告诉你做成什么样算过关，因为”做完了”和”做对了”不是一回事。
三种读法
第一种：通读。 从第一页按顺序读到最后一页。适合你有一两个月相对完整的时间，愿意系统来一遍。好处是前后勾连会自然发生——第 2 章讲信息密度的四个层级，到第 12 章讲句子的密度时我会问你”还记得四个层级吗”，这些呼应只有通读才吃得到。坏处是见效慢，你可能读到第 5 章还没觉得自己的文档变充实了。别急，第 8 章之后会开始拐弯。
第二种：按卷跳读。 全书分六卷：总论、认知地基、心法、技法、素材、打磨。你可以挑一卷整块读。卷与卷之间有依赖，但不强——你完全可以先读第三卷”技法”上手试试，再回头读第一卷”认知地基”补原理。唯一建议别跳的是第 1 章到第 5 章的”认知地基”五章，它是后面所有技法的心法根基，跨过它直接学技法，你只会变成一个”会用技巧但不知道为什么”的写作者。
第三种：当工具书查。 你手上正写着一份文档，卡住了。这时候去看目录，找对应的章节，只看那一章。本教程的每一章都尽量做到了自足——你需要的前置概念，我会在文中用一句话带过并标注”详见第 X 章”，不会让你被迫往回翻。
我的建议是：用第二种和第三种为主，找一段完整时间再通读一遍。 纯通读的人，读到后面会忘前面；纯查的人，脑子里形不成体系。先解决手头问题建立信心，再系统打底建立体系，最后通读一遍把网织起来。
关于练习
这本教程的练习题分两类。
一类是改稿。 我会给你一段”看起来漂亮但其实不充实”的文字，让你改成充实的版本。这类题最有效，因为写作能力不是看出来的，是改出来的。你看一百篇好文章，不动笔，下次写还是不会；你动手改三篇，下次写就有感觉了。
另一类是自检。 我会问你”你最近写的一份文档，它解决了什么问题”。这类题看起来虚，其实是写作里最重要的一问——大部分文档写不好，根上是写的人自己没想清楚”要解决什么问题”。
每一道练习都配自评标准。做完别只看”做没做完”，看”做没做对”。
关于这本教程的语言
这本教程用中文写，教的也是中文写作。
但有一件事要说清楚：你说”不追求中文的修辞手法”——这条原则我会贯彻到底。本教程不教成语、对仗、双关、谐音、强文化色彩的修辞——这些不是中文独有的问题，英文也有 idiom，同样要慎用。本教程教的是结构、密度、论证——这三条不是中文特有的，是非虚构写作的通用心法。
这一选择有个附带的好处：技法上你学到的东西，翻译过去依然成立。但这不是教程的目标——教程的目标是帮你把内容写充实，让中文读者读完”多知道一些东西”。
至于”国外的朋友也能欣赏”——它会自然发生。你学的是结构、密度、论证，是普世的心法；你写出来的东西，技法上不会因为翻译过去就垮掉。但这件事不必当成约束摆在心里——一摆就缩手缩脚，反而写不好。先按”充实中文读者”的要求写，技法本身的普世性会替你完成剩下那一步。
写给特定的人
这本教程主要写给这样的人：
写代码写久了，想把”想法”落下来的人。 你是 5 年 Go 后端，你对”系统”这件事有感觉，但你不一定能把这种感觉讲给别人听。这本教程帮你把”我心里清楚”变成”读者也清楚”。
写技术文档 / 设计文档 / RFC 的人。 你的同事读完你的文档，应该知道”为什么这么设计”，而不只是”这是设计”。这需要把”决定”变成”论证”。
写博客、写知乎、写公众号的人。 你想让人读完觉得”哦原来是这样”，而不是”哦”。这需要把”信息”变成”洞察”。
写答辩稿、写方案说明、写技术分享的人。 你想让人记住你说的，而不是听完就忘。这需要把”列举”变成”结构”。
如果你不属于上面任何一种，但你想学会”把脑子里的东西写下来”，这本教程也适用。它不预设文学背景，不预设写作训练，只预设一件事：你愿意动笔改。
全书地图
读完上面你应该大致知道这本教程在讲什么了。下面是完整的章节地图，每章一句话告诉你它在解决什么问题。
总论
- 00-总论与导读（你现在在读的这一篇）：把”写好”这两个字拆开，定义”充实”是什么、不是什么，给出整本教程的地图和使用说明。
第一卷：认知地基
写作这件事的”地基”——如果你脑子里这几件事没想清楚，后面所有的技法都是空架子。
- 01-把”写好”这两个字拆开：充实、修辞、结构分别是什么，它们之间什么关系。这一章回答”我们到底在追求什么”。
- 02-信息密度的四个层级：文字分四层——填充、重复、信息、洞察。大部分文章卡在第二层。这一章回答”每句话的密度够不够”。
- 03-结构清晰：读者是迷路的旅客：读者的注意力是有限的资源，结构是”路标”。这一章回答”读者读完能不能记住主干”。
- 04-论证扎实：把”我想说的”变成”读者信服的”：写文档不是写日记，需要论证。这一章回答”读者凭什么信你”。
- 05-深度优先：一个点讲透的诱惑：广度和深度不能兼得。这一章回答”为什么少写一点反而写得好”。
第二卷：心法篇
心法是”技法背后的技法”。看完技法你只会”用”，看完心法你才会”判断什么时候不该用”。
- 06-网状思维与线性文本：你脑里的想法是网状的，但读者读的是线性的。这一章回答”你为什么总是写到一半卡住”。
- 07-大纲的艺术：先建骨架，再填血肉。这一章回答”动手写之前要做什么”。
- 08-金字塔原理：从一个核心论点向下展开。这一章回答”论点怎么组织才不散”。
- 09-模块化思维：每个章节是自洽的小宇宙。这一章回答”为什么有的章节单独抽出来也能读懂”。
- 10-删减的勇气：知道什么不要写，比知道什么要写更难。这一章回答”为什么写得长容易写得短难”。
- 11-留白的力量：少即是多，但不是少就是多。这一章回答”留白和偷懒的区别在哪”。
第三卷：技法篇
从抽象到具体——句子怎么写、段落怎么排、术语怎么用、怎么写得清晰可移植。
- 12-句子的密度：一句一信息：一个句子只做一件事。这一章回答”为什么一句话塞了三件事反而读者记不住”。
- 13-段落的节奏：一段一推进：一个段落只推进一层意思。这一章回答”为什么有的段落读完知道在讲什么，有的读完一片模糊”。
- 14-语态与人称：主动 vs 被动，第一人称 vs 第二人称。这一章回答”怎么让人读得下去”。
- 15-标点与节奏：句号、分号、逗号、破折号的呼吸感。这一章回答”为什么有的文章读起来累，有的读起来顺”。
- 16-术语的一致性：一个概念用一个词。这一章回答”为什么有的文章看着专业，有的看着装”。
- 17-可移植性：让你的表达不依赖语言特性：避免双关、绕弯、文化专属典故。这一章回答”为什么有的表达换一个语言就失效”。
第四卷：素材篇
素材——案例、故事、类比、证据——是文章的肌肉。这一卷讲怎么挑、怎么用。
- 18-案例的选择：典型性 vs 边缘性，多 vs 少。这一章回答”为什么你的案例读者没感觉”。
- 19-故事的钩子：开头三秒决定读者是否继续。这一章回答”为什么要讲故事而不是讲道理”。
- 20-类比的力度：把抽象变成具体。这一章回答”为什么有的类比越用越清楚，有的越用越糊涂”。
- 21-证据的层级：数据 > 案例 > 类比 > 主张。这一章回答”凭什么让读者信”。
第五卷：打磨篇
写完不算完——开头怎么开、结尾怎么收、重写怎么重写。
- 22-开头：三种钩子的选择：直接抛出问题 / 故事切入 / 反常识。这一章回答”开头几行字怎么写”。
- 23-结尾：留给读者一个可以带走的东西：不要”总结全文”式的废话结尾。这一章回答”怎么结尾才能让人记住”。
- 24-重写：结构调整不是改词：第一稿是给自己看的，重写是结构调整。这一章回答”为什么改了三遍还是不好”。
终章
- 25-持续精进：写作是手艺活：写作不是天赋，是练习。这一章回答”学完这本教程之后怎么继续长进”。
一句话总结这本教程
如果整本教程只能浓缩成一句话给你带走，是这一句：
充实的写作，是把”我想说的”翻译成”读者能多知道一些东西”。
写作者的本事不在于”会想”，在于”会翻译”。
这本教程怎么用（给老哥的实用说明）
你拿到这本教程，有三种读法，别只选第一种。
读法一：通读建框架。 从 00 读到 25，当一本系统教材。适合你想把”写作”这件事在脑子里搭出完整骨架——知道”充实/结构/论证/密度”分别管什么，它们之间什么关系。通读一遍，你写任何东西都会下意识先问”这段充实什么、读者在哪会迷路”。
读法二：查着用。 它是一本性写作手册，不是非得从头读。要开技术文档了翻 22（开头）、要删稿翻 10（删减）、要给同事讲清一个概念翻 20（类比）、要证明一个观点翻 21（证据层级）。带着具体问题来，翻对应章，用完即走。
读法三：练着学。 只挑每章末尾的”动手练习”做，做一篇复盘一篇。写作是手艺，光读不动手等于没读——你读完会觉得”我懂了”，一写还是老样子。练才是把心法从”知道”变成”手感”的唯一路径。
每章的固定结构：场景 → 追问 → 原理 → 反例 → 心法 → 思考题（带参考答案）→ 动手练习。这套结构本身也是教的——你看多了就知道”好文章怎么组织”。思考题的答案不是用来”对”的，是当学习材料看：你看别人怎么想一个问题，比自己憋答案学得快。
一个提醒：这本教程刻意不教修辞。你最开始说”不追求修辞，把内容写充实”。所以全程围绕”充实、结构、论证、密度”打转，修辞只在第 17 章作为”可移植性”的副产品轻碰。等你把这几样练稳了，再去读修辞也不迟——到那时你有了要表达的实在内容，修辞才是锦上添花；内容空的时候堆修辞，是无病呻吟。
学写作的三个误区（先排雷）
- 误区一：写作靠天赋。 错。写作是手艺，和写代码一样靠练。没人天生会写 Go，也没人天生会写清楚。本教程每一章给的练习，就是你的”刷题”。
- 误区二：多读好文章就会写。 只读不写，你 accumulate 的是”语感”，不是”能力”。语感让你能判断”这句别扭”，但写不出”这句通顺”。必须动手。
- 误区三：先追求文采再追求清楚。 顺序反了。清楚是地基，文采是装修。地基没打就装修，塌。
阅读路线图（给没时间的你）：第一卷（01-05）是地基，必读；第二卷（06-11）是心法，至少读 06/07/08；第三卷（12-17）是技法，随用随查；第四卷（18-21）是素材，写长文前读；第五卷（22-25）是打磨，每次写开头结尾前翻。
接下来
我已经把整体框架放出来了。总论 + 导读就是你现在读的这份。
下一步我会写第一卷”认知地基”——五章，每章 8000-10000 字，预计 4-5 万字。这一卷是整本教程的地基，决定了后面所有章节你读起来是”知其然”还是”知其所以然”。
你看完这份导读，告诉我三件事：
- 风格对路不？ 这套”场景 → 追问 → 原理 → 反例 → 心法 → 练习”的路子，和你期待的一样吗？
- 书名同意吗？ 《写实的写作·把内容写充实》，或者你有更好的名字。
- 从第一卷开始写吗？ 还是你想先调整大纲里某几章的次序或内容？
确认之后，我开始写第一卷第一章节《把”写好”这两个字拆开》。