视频还是文档：什么时候该录屏，什么时候该写字

每个团队最终都会遇到同一场争论。有人说”随手录个短视频就行”，另一个人说”这应该写成文档”，然后这件事就搁置了一周，双方都在等一个结论。

答案不是哪种格式更好，而是视频和文字会在不同的地方失效。展示动作、顺序和判断，视频无可替代；便于扫读、搜索和修改，文字无可替代。选错了，你要么把两行就能说清的答案埋进八分钟的录像里，要么花一个下午用文字描述一个拖拽动作。

这篇指南给你一套可复用的判断方法——在动手之前，大约三十秒就能得出结论。

三十秒判断法

针对你要记录的内容，问三个问题。

1. 它会动吗？ 如果理解它需要看着某件事发生——光标轨迹、状态切换、动画、工具的实时反应——那就录下来。
2. 以后有人会只需要其中某一项吗？ 如果人们会回来查某个具体的值、开关或步骤，那就写下来。没人会为了找一个端口号去拖动进度条。
3. 它多久变一次？ 如果界面每个月都在变，文字的维护成本更低。如果它一年都稳定，视频就物有所值。

两个答案指向”视频”就录制，两个指向”文字”就撰写。如果各占一半，你多半两者都需要——这比听起来容易，下文会讲。

视频胜出的场景

跨工具的工作流。 大多数流程的难点不在于某一次点击，而在于应用之间发生了什么。录像能完整捕捉整条路径，你不必去描述六次上下文切换。

任何涉及视觉判断的事。 “间距再平衡一点""这个动画太快了""图表要更透气”。这些用文字无法精确表达，用十秒视频却一目了然。

缺陷报告与复现。 录像展示了确切的顺序、确切的时机和确切的状态，直接终结”我这边复现不了”的来回拉扯。

新人入职与第一印象。 新同事需要看到”熟练”是什么样子——一项任务应该多快完成、有经验的人在哪里会停顿、他们会忽略什么。文字步骤会把这些全都抹平。

你本来要口头讲三遍的内容。 如果同一件事你在三次会议上都讲过，那需要的是一段录像，而不是第四次会议。

传递语气。 反馈、带有分寸的决定，以及任何可能被读成生硬的内容，配上声音和面孔都会更容易被接受。

文字胜出的场景

参考资料。 配置项、API 参数、快捷键、错误码。所有用来查而不是用来学的东西。

必须可搜索的内容。 文字会被你的 wiki、帮助中心和搜索引擎索引。除非加上字幕，视频就是一个黑盒。

经常变动的步骤。 改文档里的一行只要几秒。重录一段、对齐音频、重新导出要花一小时——而每一帧过时的画面都在削弱整个资料库的可信度。

需要边做边看的内容。 没有人愿意一只手跑迁移脚本，另一只手暂停、回退、再播放视频。清单是拿来读的。

法务、合规以及任何需要精确措辞的内容。 如果精确比清晰更重要，就写下来、评审、做版本管理。

需要大量翻译的内容。 文字翻成十四种语言成本很低，重新录制旁白则不然。

多数团队真正需要的格式

最好的文档很少是二选一，而是一段短视频配上文字的骨架。

一个可靠的模式：

• 以文字页面作为唯一事实来源。 标题、目的、前置条件、编号步骤，以及可复制的精确数值。
• 在靠上位置嵌入一段两到四分钟的录像。 它展示这项任务的整体轮廓，让读者知道自己将要做什么。
• 章节标记和时间戳。 让视频从线性内容变成可导航的资料。
• 文字稿或字幕。 让视频内容变得可搜索，也更具无障碍性。

需要整体感觉的人去看，需要具体数值的人去扫。两类读者都不会因为对方选了另一种格式而受罚。

把录像做得够短，它才能长期有效

视频文档失效的头号原因是长度。一段涵盖八个主题的二十分钟录像，只要一个主题变了就得整个重做。八段三分钟的录像则可以逐一替换。

让视频库保持可维护的实用规则：

• 一个视频，一个结果。 如果标题里需要”和”，就拆开。
• 控制在五分钟以内。 大多数流程讲解三分钟就够。
• 不要录最容易变的部分。 价格、日期、团队名称和界面文案，应该放在视频旁边的文字里。
• 把版本说出来，或者放在画面上。 “本视频录制于 4.2 版本”这一句，能把”过时的视频”变成”有明确时点的视频”，危害小得多。
• 录得干净。 打开勿扰模式，用演示数据而不是真实客户记录，保持统一主题。一段能在三处复用的素材，胜过三段不能复用的素材。

降低录制的成本

很多”还是写文档吧”的决定，其实是”录像感觉像一场制作”。把这个成本降下来，整个团队的算法就变了。

• 省掉开场。 直接从关键画面开始。内部文档不需要十五秒的铺垫。
• 不要逐字写稿。 列五个要点，照着讲。逐字稿会让人听起来像在念，还会让准备时间翻三倍。
• 用剪辑解决问题，而不是重录。 剪掉空白、说错的句子和漫长的加载。几乎每一条素材都还有救。
• 用缩放代替解说。 对着你刚点的按钮放大，就替代了一句解释按钮位置的话。
• 一条合格的素材就够了。 内部文档不需要第四次尝试，发出去就好。

一份简单的团队规则

如果你想彻底结束这场争论，写下四行：

1. 参考与配置 → 文字。 永远如此。
2. 工作流、演示与反馈 → 视频。 五分钟以内。
3. 任务进行中要用的 → 文字清单，视频概览可选。
4. 变动频率高于每季度的 → 文字，除非画面本身就是重点。

然后加上一条比前四条更重要的规则：每段视频都要有文字标题、一句话摘要，以及来自相关文档的链接。 没人找得到的录像，等于没录过。

结语

选择格式不是风格偏好，而是你替六个月后阅读这份内容的每一个人做出的维护决定。视频买来的是理解，文字买来的是耐久。文档做得最好的团队，不是选边站的团队，而是停止争论、把值得看的录下来、把值得查的写下来、并把两者连接在一起的团队。