Documentation

常见问题与故障排除

常见问题以及偶尔出现的问题的解决方法。仍然遇到困难?在 GitHub 上提交 Issue 或加入 Discord — 我们会阅读所有内容。

常见问题

macOS 提示“无法打开 Snapzy,因为其来自身份不明的开发者。”

发生这种情况是因为 Snapzy 是在 Mac App Store 之外分发的。 打开“系统设置” → “隐私与安全性”,滚动到“安全性”部分,然后点击 Snapzy 旁边的 仍要打开。这是一个一次性的步骤。

当我按下 ⌘⇧3 / ⌘⇧4 / ⌘⇧5 时,Snapzy 和 macOS 都会触发。

这是特意设计的 — Snapzy 复用了 macOS 默认的屏幕截图键,以便迁移你的肌肉记忆。要使 Snapzy 成为唯一的处理程序,请在“系统设置” → “键盘” → “键盘快捷键” → “屏幕截图”中禁用 macOS 的内置快捷键。你也可以在 Snapzy → “偏好设置” → “快捷键”中重新映射 Snapzy 的任何快捷键。

当我按下捕获快捷键时,什么都没有发生。

当 Snapzy 在后台运行时,它需要 辅助功能 权限来使用全局快捷键。在“系统设置” → “隐私与安全性” → “辅助功能”中启用它,然后退出并重新打开 Snapzy。

我的屏幕录像黑屏,或者仅显示桌面壁纸。

你尚未授予 屏幕录制 权限。 打开“系统设置” → “隐私与安全性” → “屏幕录制”,将 Snapzy 切换为开启状态,然后退出并重新打开 Snapzy。

我该如何捕获单个窗口或应用程序?

触发区域捕获( 4)并按下 A 切换到“应用程序捕获”,或在全局使用 A。在“录制视频”中采用相同的模式,可实现仅限应用程序的录制。

我的文件保存在哪里?

Snapzy → “偏好设置” → “通用” → “保存位置”。默认是 ~/Pictures/Snapzy 。除非你选择加入“云端上传”,否则文件永远不会离开你的 Mac。

录屏文件很大。我可以缩小它们吗?

MP4 是最实用的最小格式。在“偏好设置” → “录制”中,将帧率降低至 30 fps 并保持分辨率为原生状态。对于在聊天应用中分享,可以导出为 GIF — 它在设计上经过了重度压缩。

我可以录制系统音频吗?

可以。在录制控制面板中,启用“系统音频”。麦克风输入是同一位置的一个独立开关。

有 Windows 或 Linux 版本吗?

目前还没有。Snapzy 仅限 macOS,且是为其原生构建的。由于该项目采用 BSD 3-Clause 协议开源,欢迎针对其他平台的贡献。

我该如何更新 Snapzy?

Snapzy 在启动时会通过 Sparkle 自动检查更新。你也可以手动打开 Snapzy → “检查更新”,或者从下载页面下载最新的 DMG 文件。

我该如何彻底卸载 Snapzy?

运行卸载脚本以删除该应用程序、偏好设置、缓存并重置 TCC 权限:

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/uninstall.sh | bash

你可能需要注销或重启系统,以使权限重置完全生效。

即使在点击“仍要打开”之后,macOS 仍然阻止 Snapzy。

因为 Snapzy 目前尚未经过 Apple 的公证,macOS 仍可能会将其隔离。将其安装到 /Applications, 运行:

sudo xattr -rd com.apple.quarantine /Applications/Snapzy.app

我该如何报告问题或发送诊断日志?

Snapzy 可以捆绑诊断日志用于故障排除。使用应用内的“报告问题”流程(Snapzy → 报告问题)生成日志捆绑包。这有助于维护人员在不共享你的捕获内容的情况下重现问题。

我可以清除 Snapzy 的缓存吗?

可以。Snapzy 在 Application Support 中存储临时捕获和处理文件。你可以从 Snapzy “偏好设置”中清除缓存,或者手动删除 ~/Library/Caches/com.duongductrong.Snapzy

仍然需要帮助? 加入 Discord 社区 或在 github.com/duongductrong/Snapzy/issues 提交缺陷报告。

准备好捕捉
你的最佳作品了吗?

加入开源社区,共建 macOS 最佳屏幕捕捉工具。

macOS 13+ · Intel 与 Apple Silicon