QuickRecorder：macOS 屏幕录制的零基础免费实操手册
【免费下载链接】QuickRecorderA lightweight screen recorder based on ScreenCapture Kit for macOS / 基于 ScreenCapture Kit 的轻量化多功能 macOS 录屏工具项目地址: https://gitcode.com/GitHub_Trending/qu/QuickRecorder
周五下午，你要给开发同事发一段 3 分钟的 bug 复现视频。系统自带的 QuickTime 只支持全屏录屏，右侧的聊天窗口和桌面图标全被录了进去。QuickRecorder 是一款免费开源的 macOS 屏幕录制工具，基于 ScreenCaptureKit 框架，可以只录单个窗口、单个应用，甚至录 USB 连接的移动设备画面。
项目定位速览：不到 10MB 的 macOS 录屏工具
- 用 SwiftUI 编写的 macOS 屏幕录制应用，安装包体积不到 10MB
- 底层调用 ScreenCaptureKit 系统框架做屏幕捕获，支持 Apple Silicon 与 Intel 芯片
- 免费开源，AGPL-3.0 许可证；不是沙盒 App，不上架 App Store
- 系统要求 macOS 12.3 及以上，当前版本线为 v1.6.x（v1.6.x 是最后一个支持 macOS 12 的版本）
| 适合的场景 | 不太适合的场景 |
|---|---|
| 窗口级、应用级录屏，系统声音与麦克风分轨独立导出 | 需要加字幕、转场、BGM 的成片剪辑（它只带视频修剪器和 GIF 导出） |
| 摄像头叠加 + 鼠标高亮的教学演示，USB 录制 iOS/Android 设备 | 要求沙盒签名或必须上架 App Store 的分发场景 |
| 无画面纯录音、HEVC with Alpha 透明视频输出 | 需要直播推流的场景 |
如何安装 QuickRecorder 并完成首次权限设置
首选 Homebrew 一行命令安装：
brew install lihaoyun6/tap/quickrecorder不熟悉终端的话，也可以去项目 Releases 页面下载 DMG 拖入"应用程序"文件夹，效果相同。安装后首次启动按下面顺序完成授权：
- 授予"屏幕录制"权限——即使只录系统声音，macOS 也要求这一项
- 需要麦克风输入时，再授予"麦克风"权限
- 用到鼠标高亮、屏幕放大器等辅助功能时，同步开启"辅助功能"权限
- 授权后重启 App；主面板关闭后，点 Dock 图标或菜单栏图标即可随时重新呼出
功能实战：按使用场景分组
录教学演示：macOS 摄像头叠加录屏 + 鼠标高亮怎么开 🎥
你要做一段"屏幕操作 + 出镜讲解"合一的教学视频。macOS 14 及以上选"演讲者前置（Presenter Overlay）"模式，摄像头画面实时叠加进录像；macOS 12/13 改用摄像头悬浮窗，注意录制单个窗口时摄像头浮窗不可用。在设置面板打开"Highlight the Mouse Cursor"，鼠标周围出现高亮圈，还能用快捷键呼出屏幕放大器查看光标附近的细节。技巧：开讲前先在设置里把"降低麦克风串扰（AEC）"打开，外放回音会被明显抑制，比后期处理省事。
抓 Bug 复现：macOS 窗口录制怎么设置 🐞
你要给开发发一段只包含那个出问题的窗口的复现视频，桌面杂物一概不要。选"录制窗口内容"模式，点一下窗口列表里的目标窗口即可，支持多选窗口、Esc 取消；想连窗口声音一起录就勾"录制App声音"。技巧：后期要分别调系统音量和人声音量时，在设置面板关闭"将麦克风录制到主音轨"，录制结果会拆成两条独立音轨，这就是独立音轨分离的完整操作步骤。
做纯音频播客：无画面录音 + 独立音轨导出 🎙️
你要只录系统声音加口头讲解，不出画面。选"录制系统声音"模式并勾选麦克风输入；音频格式可选 AAC、MP3 等，多轨录音还能存成 .qma 容器格式（QuickRecorder 专属的多轨音频包），在剪辑软件里按轨处理。技巧：用 AirPods 麦克风录制的用户注意，v1.5.2 修复了人声被加速的问题，版本偏旧就先升级再录。
录 USB 连接的 iOS 设备与屏幕区域 📲
你要录一段真机演示，或只想录屏幕里的一块固定区域。USB 连好设备后选"录制移动设备"模式，在列表里选中设备即可，iOS/Android 都支持；多显示器用户用"录制屏幕区域"模式，它会自动恢复上次的选择区域，也能精确指定区域尺寸。技巧：超过一小时的长录制先在设置里开启"录制时阻止 Mac 睡眠"，避免系统休眠把文件写断。
参数与性能调优
帧率与输出质量在主面板直接下拉选择，编码器在 H.264 与 H.265 之间切换。三组常用预设：
| 使用场景 | 推荐编码 | 帧率 | 质量/码率 | 约文件大小（每小时） |
|---|---|---|---|---|
| 日常文档操作、网页浏览 | H.264 | 30fps | 中 | 约 80–150MB |
| 高画质教学演示、游戏演示 | H.265 | 60fps | 高 | 约 200–300MB |
| 4 小时以上会议长录 | H.265 | 24fps | 低–中 | 约 40–80MB |
H.264 兼容性最好，任何设备即插即播；H.265（HEVC）同画质下体积大约省三分之一，还支持带 Alpha 透明通道的 HEVC with Alpha 输出，目前仅 iMovie 与 FCPX 能读取这种文件。分辨率过高导致 H.264 硬件编码不支持时，App 会弹窗建议切 H.265。
常见问题速查
录不出画面或黑屏→ ① 系统设置 > 隐私与安全性 > 屏幕录制，确认勾选 QuickRecorder ② 授权后重启 App ③ 系统是 macOS 12.7.4 的话升级到 12.7.5，该版本有文件随机损坏的已知问题
录制里没有系统声音→ ① 确认选的是"录制系统声音"模式 ② 关闭"将麦克风录制到主音轨"时系统音在独立轨，用剪辑器分轨听 ③ 重启 App 后重新授权
文件太大→ ① 编码换 H.265 ② 帧率 60fps 降到 30fps ③ 输出质量降到中档
录制卡顿、CPU 占用高→ ① 降低分辨率或质量 ② 按弹窗提示从 H.264 切到 H.265 ③ 用"屏幕区域"代替全屏录制
源码入口
- QuickRecorder/RecordEngine.swift：录制引擎核心，改录制行为从这里入手
- QuickRecorder/SCContext.swift：ScreenCaptureKit 捕获上下文，改捕获源与音轨逻辑看这里
- QuickRecorder/ViewModel/：摄像头叠加、窗口选择器、设置面板等 SwiftUI 界面，改界面从目录入手
行动指引
QuickRecorder 最大的亮点是免驱动的系统声音环回录制加麦克风独立音轨导出，核心功能全部免费。它最适合需要频繁录窗口级复现视频和教学演示的开发者、教师。今天花一分钟跑完那条 brew 命令，下一条复现视频就可以只录一个窗口了。
项目地址：源码获取git clone https://gitcode.com/GitHub_Trending/qu/QuickRecorder系统要求：macOS 12.3 及以上（Apple Silicon 与 Intel 均支持）许可证：AGPL-3.0
【免费下载链接】QuickRecorderA lightweight screen recorder based on ScreenCapture Kit for macOS / 基于 ScreenCapture Kit 的轻量化多功能 macOS 录屏工具项目地址: https://gitcode.com/GitHub_Trending/qu/QuickRecorder
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
