如何在 Mac 上截取有用的错误报告截图
好的截图能展示哪里出了问题;有用的错误报告还会说明如何复现。
只给出出错画面的截图,仍会留下几个问题:是什么操作导致了问题?原本应该出现什么结果?每次都会发生吗?搭配聚焦的截图和简短说明,调查问题的人才有办法复现。
下面介绍报告 Mac 应用或网站问题的实用流程,并附上可复制到问题追踪系统或支持消息中的模板。
1. 在画面中保留足够的上下文
尽量把出错的控件和结果一起截进去。如果点“保存”后出现错误,就包含按钮、错误信息和相关表单。整个桌面会让小细节难以查找;单独截取错误信息,又可能看不出它来自哪个画面。
重现问题时使用示例内容。裁掉无关的标签页和账户信息。最好在截图前先从源画面中移除凭据和私人信息;轻微模糊无法可靠地遮住文字。
Floatie 的区域截取会让截图悬浮在屏幕上,方便你返回应用检查步骤。若还需要展示另一个状态,请另外截一张图。
2. 标出观察到的问题,再补充说明
通常用一个箭头指向出错控件就够了。需要按顺序阅读时再添加编号,并在附件旁写清楚说明。不要把标注画在错误信息本身或能证明问题的数值上。
选中 Floatie 截图后按 ⌘E,即可打开 Pro 编辑器,添加箭头、文字和编号。编辑器功能页介绍了各项工具。
周五前发货。
已保存卡号——请勿重复发送。
如果错误只出现在图片中,可以用 OCR 复制其中的文字。请对照原图检查复制结果,尤其注意标点和外观相似的字符。报告中除了图片,也要附上可搜索的错误文本。
3. 添加这份问题复现模板
以下示例纯属虚构,请替换成你实际观察到的内容。
标题:输入项目名称后,“保存”仍处于禁用状态
环境:
- 应用和版本:
- macOS 版本:
- 浏览器和版本(如适用):
步骤:
1. 新建一个项目。
2. 输入名称。
3. 尝试选择“保存”。
预期结果:输入有效名称后,“保存”按钮变为可用。
实际结果:“保存”按钮仍处于禁用状态。
发生频率:3 次尝试中复现 3 次。
附件:project-save-disabled.png
按实际测试情况填写发生频率。如果只发生过一次,就如实写明。若网站布局问题会受窗口尺寸或缩放设置影响,也请记录这些信息。
4. 选择截图还是屏幕录制
数值错误、标签缺失或布局损坏等问题适合用截图说明。菜单消失、意外滚动或一连串点击操作等问题,则更适合用短视频记录。只录制屏幕中相关的部分,问题行为显示出来后就停止。
问题报告需要长期保留附件时,请上传文件。提交前打开附件,确认重要文字清晰易读。如果遇到文件大小限制,可以缩小截图,同时保留相关细节。
准备好体验悬浮了吗?
免费试用 14 天,所有功能全部解锁。之后,一次性购买可永久使用 Floatie Pro,或选择月度或年度方案,同时获得 Floatie Link Pro。