如何录制让人真正跟得上的终端与命令行演示

终端演示是开发者能制作的最实用的视频之一，同时也是最难看下去的视频之一。极小的等宽文字、不断滚动的输出、还没读完就从屏幕顶端消失的命令——观众看两分钟就放弃了。

解决办法几乎全在准备阶段。一段清晰可读的终端录制是在按下录制键之前做好的，而不是事后补救出来的。下面是完整流程。

终端录制为什么难看

图形界面的录屏有视觉锚点：按钮、图标、布局。终端没有。所有内容大小相同、颜色相同，而且滚动很快。问题总是那几个：

• 文字太小：在眼前看着舒服的字号，在小窗口播放的 1080p 视频里根本看不清
• 低对比度主题：近黑背景上的暗灰色在显示器上很优雅，经过视频压缩后就消失了
• 一闪而过的输出：你还在讲解命令，关键那一行已经滚走了
• 看不见的输入：观众看不到你的按键，快速敲出的参数看起来就像变魔术
• 空白时间：安装、构建和测试会带来三十秒什么都不发生的等待

这些问题每一个都能在五分钟内解决。

录制前先设置好终端

把演示用的终端当作和日常工作终端不同的环境。大多数终端应用支持配置文件——新建一个名为「Recording」的配置，设置一次即可。

• 字号 18–24pt：大约是你平时用的两倍。如果在显示器上显得夸张，那在视频里多半刚刚好
• 高对比度主题：纯色深底、明亮前景。完全不要使用透明和背景图片——它们压缩效果差，还增加视觉噪音
• 调整窗口大小，而不是全屏：过大的全屏终端会让文字相对画面变小。90–100 列左右的窗口正好填满 16:9 画面
• 必要时关掉连字：把 -> 和 != 变成箭头符号的花哨字形，会让想照抄命令的观众犯迷糊
• 稍微加大行距：一点点留白就能让密集的输出好读很多

清理你的 Shell

提示符和历史记录承载的信息比你以为的多。录制前：

• 简化提示符：包含 git 分支、Node 版本、时间戳和两行路径的长提示符既占横向空间又分散注意力。简短的 ~/project $ 最理想
• 隐藏用户名和主机名：在可能公开的视频里，这些信息能识别出你和你的机器
• 清空回滚缓冲区和历史记录：之前的命令可能暴露客户名称、内部主机名或无关工作
• 检查环境变量：视频里的 env 输出泄露的 API 密钥比任何代码片段都多
• 使用一次性目录：干净的项目文件夹能避免 ls 输出里混进无关文件
• 关闭通知：终端提示音和桌面弹窗都会打断一条完整的录制

如果演示确实要用到真实凭据，请改用假值。事后打码远比事先设置 API_KEY=demo-key-1234 费劲。

规划命令顺序

录制前把要敲的命令写下来——写进草稿文件，而不是靠记忆。一份按顺序列出你将输入什么的简短脚本有三个作用：避免你在紧张时打错字、让演示保持一条主线，并直接成为你的旁白提纲。

然后不录制地完整走一遍。这能发现意外：缓存其实已经预热、某个依赖需要先装、有个你忘了的确认提示。走完后把目录恢复原状，让正式录制从相同状态开始。

终端工作的录制设置

终端内容多为静态文字，因此在某些方面很宽容，在另一些方面很苛刻。

• 录窗口而不是整个屏幕：窗口捕获让画面紧贴终端，挡住桌面上的其他一切
• 30fps 足够：文字不需要 60fps。更低的帧率还意味着相同码率下文字更锐利
• 按显示器原生分辨率录制：事后放大文字正是模糊的来源
• 不加摄像头画中画，或者保持很小：终端演示的主角是输出。大的画中画会遮住右下角，而新输出恰恰出现在那里

大多数人做错的地方：节奏

好的终端演示的节奏，和你实际工作的节奏并不一样。

1. 动手前先说出你要做什么：「现在我要全局安装这个 CLI」
2. 以稳定、清晰的速度输入——比平时慢一些，但不要慢得不自然
3. 按回车前停顿一拍，让完整命令有被看清、读完的时间
4. 输出出现时保持安静，然后再讲解
5. 指出重点，而不是把输出整段念出来

对于很长的命令，可以分两步可见地输入——先敲基础命令，再补上参数——同时解释每个参数的作用。这比四十个字符一次性出现好跟太多了。

处理耗时很久的命令

没人想看九十秒的 npm install。你有三个好选择：

• 变速处理：保持命令可见，但把等待段以 4–10 倍速播放，让观众知道它发生过，而不必陪着等
• 剪掉等待：从命令开始处剪到结果出现前。在提示符行上剪，剪辑点就看不出来
• 提前预热缓存：录制前先跑一次，正式录制时它自然只需几秒

无论选哪种，都请口头说明真实耗时——「这一步通常要两分钟左右」——这样别人自己动手时才不会意外。

在编辑器里让输出更易读

编辑环节能把一段还行的终端录制变成一段出色的录制。

• 放大重要输出：把镜头推向关键的那三行，远比让观众眯着眼看满屏日志有效
• 为关键命令加文字叠层：把命令做成字幕留在画面上，观众在听旁白的同时有东西可读
• 标注错误信息：当你刻意展示一次失败时，请突出解释原因的那一行
• 添加章节：安装、配置、首次运行、排错——终端演示是边看边做的，观众常需要往回跳
• 移除静音：自动静音移除能收紧命令之间的空隙，又不影响你的讲述

终端与其他窗口混用

真实的演示很少只有终端。你会运行命令、切到浏览器确认、再改配置文件。

• 录制前定好布局：终端与浏览器并排，或者全屏切换——选一种并坚持到底
• 切换窗口前先停一下：给观众半秒钟意识到画面变了，再继续说话
• 保持字号一致：大字号终端旁边的小字号编辑器会变得无法阅读
• 考虑区域捕获：如果两个窗口的布局固定，捕获那块区域能让整段视频的构图保持稳定

录制前检查清单

[ ] 已启用录制配置：大字号、高对比度主题、无透明
[ ] 提示符已简化，用户名与主机名已隐藏
[ ] 回滚缓冲区与历史记录已清空
[ ] 敏感信息已替换为假值
[ ] 命令顺序已写下并预演一次
[ ] 工作目录重置为干净状态
[ ] 通知与终端提示音已关闭
[ ] 已选择窗口捕获、30fps、原生分辨率
[ ] 已用十秒测试录制检查可读性

最后一项最重要。录十秒，按观众实际观看的尺寸回放，问自己文字是否读得舒服。若不舒服，先放大字体再试一次，然后再开始十二分钟的正式录制。

常见错误

• 在 4K 显示器上全屏录制：导出视频里的文字小到看不清
• 频繁清屏：观众会丢失刚刚发生了什么的上下文
• 录制途中调整终端大小：文字重排，观感突兀
• 逐字念输出：改成概括——「十二个测试全部通过」
• 让光标在静止画面上一直闪：剪掉这些尾巴，它们会让视频显得卡住了
• 默认观众认识你的别名：如果你敲 gs，请说明那是 git status

结论

终端演示的成败取决于可读性。把字体调大，选高对比度主题，清理提示符，预演一遍流程，每条命令在回车前留一拍。然后在编辑阶段用缩放效果和变速，把注意力牢牢锁在关键输出上。做到这些，你的命令行讲解就不再是让人硬撑着看完的视频，而是别人会打开终端跟着一起做的视频。