跳到主要内容
工作流程 2026年9月23日 · 2 分钟阅读

如何在 Mac 上截取有用的错误报告截图

好的截图能展示哪里出了问题;有用的错误报告还会说明如何复现。

只给出出错画面的截图,仍会留下几个问题:是什么操作导致了问题?原本应该出现什么结果?每次都会发生吗?搭配聚焦的截图和简短说明,调查问题的人才有办法复现。

下面介绍报告 Mac 应用或网站问题的实用流程,并附上可复制到问题追踪系统或支持消息中的模板。

1. 在画面中保留足够的上下文

尽量把出错的控件和结果一起截进去。如果点“保存”后出现错误,就包含按钮、错误信息和相关表单。整个桌面会让小细节难以查找;单独截取错误信息,又可能看不出它来自哪个画面。

重现问题时使用示例内容。裁掉无关的标签页和账户信息。最好在截图前先从源画面中移除凭据和私人信息;轻微模糊无法可靠地遮住文字。

Floatie 的区域截取会让截图悬浮在屏幕上,方便你返回应用检查步骤。若还需要展示另一个状态,请另外截一张图。

2. 标出观察到的问题,再补充说明

通常用一个箭头指向出错控件就够了。需要按顺序阅读时再添加编号,并在附件旁写清楚说明。不要把标注画在错误信息本身或能证明问题的数值上。

选中 Floatie 截图后按 ⌘E,即可打开 Pro 编辑器,添加箭头、文字和编号。编辑器功能页介绍了各项工具。

试一试
发票 #2041 PAID
账单收件人Jane Doe
Emailjane.doe@example.com
Card•••• 4242
总计$1,240.00
备注

周五前发货。

已保存卡号——请勿重复发送。

选择一个工具,然后在截图上绘制
试着添加清楚的标注,同时不要遮住要报告的细节。

如果错误只出现在图片中,可以用 OCR 复制其中的文字。请对照原图检查复制结果,尤其注意标点和外观相似的字符。报告中除了图片,也要附上可搜索的错误文本。

3. 添加这份问题复现模板

以下示例纯属虚构,请替换成你实际观察到的内容。

标题:输入项目名称后,“保存”仍处于禁用状态

环境:
- 应用和版本:
- macOS 版本:
- 浏览器和版本(如适用):

步骤:
1. 新建一个项目。
2. 输入名称。
3. 尝试选择“保存”。

预期结果:输入有效名称后,“保存”按钮变为可用。
实际结果:“保存”按钮仍处于禁用状态。
发生频率:3 次尝试中复现 3 次。
附件:project-save-disabled.png

按实际测试情况填写发生频率。如果只发生过一次,就如实写明。若网站布局问题会受窗口尺寸或缩放设置影响,也请记录这些信息。

4. 选择截图还是屏幕录制

数值错误、标签缺失或布局损坏等问题适合用截图说明。菜单消失、意外滚动或一连串点击操作等问题,则更适合用短视频记录。只录制屏幕中相关的部分,问题行为显示出来后就停止。

问题报告需要长期保留附件时,请上传文件。提交前打开附件,确认重要文字清晰易读。如果遇到文件大小限制,可以缩小截图,同时保留相关细节。

下次报告问题时试用 Floatie

← 所有文章

准备好体验悬浮了吗?

免费试用 14 天,所有功能全部解锁。之后,一次性购买可永久使用 Floatie Pro,或选择月度或年度方案,同时获得 Floatie Link Pro。

macOS 14 Sonoma 或更高版本 · Apple Silicon 与 Intel · 沙盒运行——一切都不会离开你的 Mac