导言先给出答案,做法是:第一段用一两句话直接说明“发生了什么、最可能的原因是什么、下一步先查什么”,然后再展开背景、证据和细节。读者在开头就知道结论,后面内容只是验证和补充。判断导言是否合格,可以问自己:如果读者只读第一段,他能不能知道该做什么?能,就是先给了答案;不能,就只是铺垫。
导言的结构可以固定为三部分:结论、依据、行动。结论回答“问题是什么”,依据回答“为什么这么判断”,行动回答“接下来查什么”。例如,一篇讲“网站维护内容更新后页面打不开”的文章,导言可以写成:页面打不开,最可能的原因是维护时改动了模板或权限配置;先检查最近一次修改记录和服务器错误日志,再决定回滚还是修复。这句话没有展开技术细节,但读者已经知道方向。
适用条件是:问题有明确现象,且存在几种常见原因。如果现象本身还没描述清楚,导言应先帮读者把现象归类,而不是急着给唯一原因。判断结果是:读者能复述出“先查什么”,导言就合格;读者只看到“这个问题很重要”,导言就失败。
下面是一份可执行清单,每项都包含要查什么、怎么查、结果说明什么。按顺序执行,不要跳步。
这份清单的适用条件是:问题已经出现,且需要收集证据再定位。如果只是预防性维护,清单应改为检查备份、监控和更新计划,而不是排查故障。
导言先给答案,不等于导言先下结论。没有证据时,只能写“可能原因”;有了日志、状态码或对比结果,才能写“已定位原因”。例如,“页面打不开”可能由权限、代码、缓存、网络多种原因造成,不能在没有检查前断言只有一种原因。正确写法是:目前最可能的原因是权限配置,下一步用日志确认;如果日志没有权限记录,再查缓存和网络。
判断标准是:每一条原因后面都能跟一个检查动作。如果一条原因无法检查,它就不该出现在导言里。适用条件是:问题现象复杂、原因不唯一。结果是:读者既能得到方向,也不会被过早锁定在错误结论上。
导言不是摘要,不需要把全文压缩一遍。三到五句足够:一句结论,一句依据,一句行动,必要时再加一句边界说明。超过这个长度,读者会失去重点;少于这个长度,可能缺少行动指向。
检查项:删掉导言后,正文是否仍然能独立成立?能,说明导言没有承担必要信息;不能,说明导言已经给出了关键答案。下一步是拿一篇现有文章,把导言改成“结论—依据—行动”三句,再对照清单逐项验证,直到读者只读开头就知道先查什么。