开发者屏幕录制指南：代码演示与技术文档

越来越多的开发者开始借助视频来传达复杂的技术概念。一段两分钟的代码演示可以替代十页的技术文档，而且团队成员真的会去看。下面介绍如何用 Recorded 制作高质量的开发者视频。

开发者为什么要录制视频

文字文档很快就会过时。视频可以边展示边讲解，让以下工作变得轻松许多：

• 新工程师入职 — 帮助他们快速熟悉陌生的代码库
• 解释 PR 改动 — 在代码评审前分享变更背景
• 记录架构决策 — 为未来的参考留下决策文档
• 分享调试过程 — 让团队从问题排查中共同学习
• 演示 API 用法 — 用实际运行的示例直观展示

核心优势在于：观众能看到你真实的思维过程、鼠标轨迹和实时运行的代码——这些都是 README 无法传递的上下文信息。

配置录制环境

按下录制键之前，先把工作区调整到最清晰的状态。

1. 使用简洁的代码编辑器主题

高对比度主题是屏幕录制的必备条件。深色背景搭配亮色主题，或者 One Dark Pro、Dracula 等流行的深色主题都很适合。将编辑器字体大小调整到至少 16–18px，确保在较小的视频播放器中代码依然清晰可读。

2. 关闭无关窗口和通知

讲解途中弹出通知是最影响专注度的事情。录制前请：

• 开启系统的勿扰模式
• 关闭所有无关的浏览器标签页和应用程序
• 如果 Dock 或任务栏会干扰视觉，将其隐藏
• 使用独立的终端窗口，并调大字体（18–20px）

3. 选择合适的捕获模式

在 Recorded 中选择窗口捕获，可以聚焦于你的代码编辑器或终端，让录制画面更紧凑，同时屏蔽桌面的多余元素。如果需要在编辑器、浏览器、终端等多个应用之间切换，则改用全屏捕获。

构建技术视频结构

结构清晰的演示更容易被观众理解，制作起来也更顺畅。推荐使用以下框架：

PREP 结构

环节	时长	目的
Problem（问题）	15–30秒	说明要讲什么，以及为什么重要
Result（结果）	10–15秒	先展示最终效果（演示先行）
Explanation（讲解）	60–90秒	逐步拆解代码
Pointers（要点）	15–30秒	指出注意事项、替代方案或后续步骤

在讲解实现细节之前先展示完成的功能效果，能显著提升观众的专注度和留存率。

代码演示录制技巧

用缩放效果突出关键代码

Recorded 的缩放功能在代码视频中非常实用。在讲解某个函数或代码行之前：

1. 添加缩放关键帧，将相关代码块居中显示
2. 缩放倍数保持在 1.5x–2x——足以阅读，又不至于失去上下文
3. 每个环节结束后平滑缩出，展示整体全貌

这样可以自然引导观众的视线，让他们不必暂停视频或凑近屏幕查看。

开启光标高亮

在 Recorded 设置中开启光标点击高亮。这样鼠标点击会以发光圆环的形式显示，在以下场景中尤其有用：

• 在文件不同位置之间点击切换时
• 演示键盘快捷键时
• 展示交互式 UI 行为时

录制短小精悍的片段

每段视频目标时长为 3–7 分钟。如果演示内容偏长，可以拆分成系列：

• 第一集：整体概览与架构
• 第二集：实现细节深入解析
• 第三集：测试与边界情况

短视频在出错时更容易重录，观众也可以直接跳到所需的内容。

有效地为代码配音

声音和画面同样重要。请遵循以下原则：

在合适的抽象层次上朗读代码。 不要逐字读出，而是解释意图。与其说 “const result 等于 await fetch 左括号 URL 右括号 点 then 左括号…”，不如说 “我们 fetch 这个 URL，并将响应解析为 JSON”。

关键说明后留出停顿。 给观众时间阅读和吸收，再继续往下讲。

点出不直观的决策。 “这里使用 Map 而不是普通对象，是因为需要保证插入顺序” ——正是这类洞察让视频变得有价值。

坦诚承认复杂性。 “这部分比较复杂，我来慢慢讲” 能帮助调整观众预期，建立信任感。

高效分享开发者视频

用于 PR 审查

导出为 MP4 并直接附加到 PR 描述中。GitHub 等平台原生支持视频上传。一段 2 分钟的变更演示视频，能大幅提升代码审查的效率。

用于团队知识库

采用统一的命名规范：YYYY-MM-DD-主题名称.mp4。将视频存放在共享文件夹（Notion、Confluence、Google Drive）中，与相关文档放在一起。

用于异步沟通

如果团队跨时区工作，可以用录制好的演示视频替代部分同步会议。将关键时刻导出为 GIF，方便在 Slack 中快速预览，再附上完整视频的链接。

典型应用场景

架构决策记录（ADR）： 录制一段 5 分钟的视频，解释为什么选择某种技术方案。未来的你和团队成员都会感谢这段视频。

调试过程记录： 在排查棘手 bug 的过程中同步录制。即使是失败的尝试也很有价值——它们展示了哪些方法行不通，以及原因所在。

代码审查回复： 用 60 秒的视频回应审查意见，替代冗长的评论往来。

库/API 演示： 通过现场编码演示新的内部库的用法，比单纯的文字说明更容易让团队上手。

录制前快速检查清单

[ ] 编辑器字体大小 16–18px
[ ] 高对比度颜色主题已启用
[ ] 勿扰模式已开启
[ ] 无关窗口已全部关闭
[ ] 终端字体大小 18–20px
[ ] Recorded 设置为窗口或全屏捕获模式
[ ] 已为关键环节规划缩放效果
[ ] 光标高亮已启用
[ ] 目标录制时长：3–7 分钟

开发者文档不必是一件苦差事。借助屏幕录制，你可以创作出团队真正会用的、有生命力的文档——而且其准确性能比任何 Wiki 页面都维持得更久。

现在就开始录制你的下一个代码演示，亲身感受其中的不同。