判断一篇教程有没有用，只看一件事：用户读完能不能在六十秒内做完那件事。
一、一篇「功能演示」和一次真实卡点
陈砚的报销工具有一个「批量审批」功能。他录了一段四分钟的视频，从登录开始，把筛选、全选、审批、导出结果全流程走了一遍，配上背景音乐，放在帮助中心首页。
一个月后，他还是收到工单：「批量审批在哪里」「为什么我只能一条一条点」。他把视频链接发过去，用户回：「看完了，但我这边没有那个按钮。」
以下情境为教学假设，人物、引语和数字不代表经核实的真实案例。
问题出在两处。第一，视频从登录开始讲，用户在第三十秒才看到审批按钮，而他卡住的地方在第十五秒的筛选条件；第二，视频里用的是管理员账号，普通成员根本看不到那个按钮，而教程没有写这条前置条件。
他后来把视频砍掉，改成一篇三百字的图文 tutorial：标题是「一次审批二十条报销」，第一句写「仅管理员可见」，然后三步，每步一张截图，最后写「审批后列表状态变为已通过」。同类工单从每月九张降到两张。
教程的价值不在覆盖多少功能，而在替用户跨过一个具体的卡点。 功能演示看着完整，却经常跨不过那个卡点。
二、五块模板：目标、前提、三步、标志、失败
一篇教程只需要五块，顺序固定。任何一块缺失，用户都会在某个环节掉出去。
| 区块 | 写什么 | 例子 |
|---|---|---|
| 目标 | 做完之后得到什么 | 一次审批二十条报销单 |
| 前提 | 权限、套餐、版本、数据 | 仅管理员；需至少 20 条待审批 |
| 三步 | 每步一个动作 + 一张截图 | 筛选 → 全选 → 审批 |
| 成功标志 | 屏幕上能看到什么 | 列表状态变为「已通过」 |
| 失败处理 | 最常见的一个失败与出口 | 看不到按钮 → 检查角色，或联系支持 |
目标要从用户的结果写，不要从功能写。 「使用批量审批功能」是功能；「一次审批二十条报销」是结果。后者能让人立刻判断「这是不是我需要的」。
前提要写在最前面，而且要具体。 「需要一定权限」没有用；「仅管理员，成员账号看不到审批按钮」才有用。教程最常见的失败不是步骤写错，而是用户根本不具备前提。
三步是上限，不是标准。 能两步做完就写两步。超过五步的任务，应该拆成两篇教程，或者在产品里做引导，而不是硬塞进一篇长文。
成功标志要能被用户自己确认。 「操作完成」不算；「列表里每一行的状态从待审批变成已通过」才算。
三、截图规范：一张图只讲一个动作
截图是教程里最容易过期的部分，也是最容易泄露信息的部位。两条规矩先立住：一张图只讲一个动作；图里不出现真实客户数据。
| 规范 | 做法 | 原因 |
|---|---|---|
| 单动作 | 每步一张，必要时加局部放大 | 一张图三个红框，用户找不到重点 |
| 标注 | 红框或箭头只标一个位置 | 标注过多等于没有标注 |
| 尺寸 | 宽度统一，关键区域不小于 600 像素 | 移动端与高分屏都要看清 |
| 数据 | 用演示账号、假名字、假金额 | 真实邮箱、订单号、客户名必须打码 |
| 版本 | 截图角落标注版本号 | 出问题时能快速判断是否过期 |
打码不是模糊处理整张图。 该打码的是邮箱、手机号、订单号、客户名称与头像；界面结构要保留清晰。整张模糊等于没截。
演示数据要跨截图一致。 第一张图里客户叫「示例公司 A」，第三张图里不能变成「测试客户 1」。不一致会让用户以为自己在看两个不同的流程。
截图最好由脚本或固定演示账号生成。 手工截十几次，每次的数据都不一样，返工时很难复现。固定一个演示租户，每次发版前重新截一遍，成本会低很多。
四、录屏边界与版本同步
录屏不是图文的高级版。它适合「连续动作」和「状态变化」，不适合「需要反复对照的步骤」。
| 适合录屏 | 不适合录屏 |
|---|---|
| 拖拽排序、画布操作 | 填表单、改设置 |
| 动画或过渡效果 | 需要边看边操作的步骤 |
| 多窗口之间的联动 | 错误码与排查路径 |
| 三十秒内能讲完的单一任务 | 超过两分钟的多任务流程 |
录屏控制在六十秒内。 超过一分钟，用户会拖动进度条，然后错过关键帧。确实需要更长的，拆成多段，每段一个任务。
录屏不配背景音乐。 用户在办公室或公共场合打开，音乐只会让他关掉声音，然后连讲解也听不到。
录屏要配文字稿。 有人不看视频，有人静音看，有人需要复制其中的命令或字段名。文字稿不必逐字对应，但步骤、按钮名与成功标志必须一致。
录屏的维护成本高于图文。 界面一改，视频要重录；图文只需换一张截图。所以只在「动作连续性本身就是难点」的地方用录屏，其余用图文。
教程的成本要分两块算：一次性制作，和每次发版的维护。
首批 8 个任务教程
截图：24 张 × 15 分钟 = 360 分钟 = 6 小时
录屏：2 段 × 30 分钟 = 60 分钟 = 1 小时
合计 7 小时 × 60 美元/时 = 420 美元（一次性）
每次发版维护：2 篇受影响教程 × 20 分钟 = 40 分钟
一年 12 次发版 = 480 分钟 = 8 小时 = 480 美元/年
教程的入口要和工单入口放在一起。 用户在排查树或 FAQ 里卡住时，下一步应该是教程，而不是重新搜索；三处互链，才不会出现「写了但没人看」。
完成率抽检 10 人，8 人能在六十秒内完成目标任务，完成率 8 ÷ 10 = 80%。样本只有十人，这个数字只能作为方向，不能当成总体比例。
维护成本要按「受影响的教程数」算，不是按总教程数。 一次发版通常只动两三个界面，其余教程不受影响。把「每次发版重截全部截图」当成规矩，维护成本会高到没人愿意执行。
发版清单里要有一行「检查受影响教程」。 改动涉及哪个页面，就检查哪些教程；截图与文字路径都要过一遍。没有这一行，教程会在半年内全部过期。
教程也要有下线机制。 功能删了、流程改了，旧教程要下架或标注「已过期」，不能留在搜索里继续误导人。下架比修改便宜，也更诚实。
五、行动清单与复算验收
先选任务，再选形式。先拍视频再想讲什么，通常会拍成功能演示。
- 从工单里选出八个「用户反复卡住」的任务，按工单量排序。
- 为每个任务写一句结果导向的目标，而不是功能名。
- 写清前提：权限、套餐、版本、所需数据。
- 把步骤压到三步以内，每步配一张单动作截图。
- 用演示账号重截，打码所有真实邮箱、订单号与客户名。
- 写出可观察的成功标志与一个最常见失败的处理方式。
- 只在连续动作类任务上录屏，控制在六十秒内并配文字稿。
- 把「检查受影响教程」写进发版清单，并给旧教程设下架规则。
验收标准：任意一篇教程，用户读完能在一分钟内完成目标任务，并且能自己判断有没有做对。
使用边界与实操验收
本文只处理异步的图文教程与短视频，不涉及一对一客户培训、现场演示与帮助中心的整体结构。
一对一培训不归本文。 有人带着走一遍、可以随时提问的场景，与无人值守的教程是两件事；前者属于客户培训，后者才是自助内容。
教程不替代产品内引导。 如果一个问题在教程里讲了十遍，用户还是卡住，说明该改的是界面，不是再写一篇教程。教程是补丁，不是解决方案。
隐私打码没有例外。 即使截图只发给一个客户，也不要把另一个客户的真实数据放进去。演示账号是最省事的做法。
关键参考与核验范围
核验日期：2026-10-25。以下链接仅作为公开文档入口，用于核对截图可访问性与任务型写作的通用要求，本文未逐条引用其内容。
- W3C WAI 图片教程 ：用于核对截图的替代文本与可访问性写法。
- Google 技术写作课程 ：用于核对面向任务的步骤与前置条件写法。
引用口径。 本文只借用两份材料的要求：图片要有可读的替代说明，步骤要面向任务而非功能。文中的 8 个教程、24 张截图、7 小时与 80% 全部来自教学假设，与上述材料无关。
核验范围。 核验的是「五块模板 + 截图规范 + 录屏边界」这套做法是否仍然可操作，不是比对某个截图或录屏工具。工具会变，模板不变。
如何自行复核。 找一位没用过产品的同事，给一个任务，只看教程、不说话，计时看他能否在一分钟内完成；卡在哪一块，就修哪一块。
系列导航
继续阅读
探索更多技术文章
浏览归档，发现更多关于系统设计、工具链和工程实践的内容。