Bug 报告用的截图。
一张包含完整报错、足够上下文,并在正确位置有一个箭头的截图,能让工单更快解决。下面介绍该展示什么、怎么标注,以及粘贴到 Jira、GitHub 或 Teams 之前要隐藏什么。
按住 Shift 画直线,Ctrl 画矩形,Ctrl + Shift 画箭头。
什么样的截图适合用在 bug 报告里?
好的 bug 截图能展示错误和它发生的位置:完整的报错信息、出现问题的界面或字段,必要时还有网址、环境或版本。箭头或方框指出该看哪里,简短的标签说明哪里不对。
截图是对文字报告的补充。就像 Mozilla 的 bug 撰写指南所建议的,复现步骤、预期结果和实际结果仍然需要用文字写出来。错误信息和日志要以可复制的文本贴进去,方便处理工单的人搜索。
在 Windows 上,Win + Shift + S 负责裁剪,截图工具负责标注。用 Sincron Screen Tools 的话,Ctrl + Shift + D 在屏幕上标出问题,Ctrl + Shift + C 连同标记一起截图,可以直接用 Ctrl + V 粘贴。
审核于 2026年10月5日
bug 截图需要展示什么
完整的报错信息
包括出现的错误码、日期和时间。如果裁剪时把信息的最后一行裁掉了,别人就得再要一张截图。
发生的位置
保留足够的屏幕内容,让人认得出来:标题、菜单或页眉。一个没有上下文的红色字段,说不清错误出在哪个界面。
一个问题,一个标记
直接在问题上画一个箭头或方框。有两个问题,就发两张截图,或者做两个带不同标签的标记。
你使用的输入
你输入的值、使用的筛选条件和所处的环境(预发布还是生产),能解释一半的 bug。如果截图里放不下,就写进工单文字里。
预期与实际
在错误的值旁边加一个“应为 120 元”这样的标签,不用读完整个工单,就能看出差距。
别的都不要
客户数据、令牌、其他标签页和通知都要排除。工单传播的范围比你想的更远。
bug 报告截图的 5 步流程
从屏幕上的错误,到粘贴进工单的截图,中间不用保存任何文件。
复现问题,停在报错处
沿着操作路径走到问题出现,让屏幕停在那里。边做边记下步骤:它们要写进工单文字里。
在屏幕上做标记
按 Ctrl + Shift + D。按住 Ctrl + Shift 拖动画箭头,按住 Ctrl 在字段周围画方框,按 T 输入简短的标签。下层的应用保持打开。
连同标记一起截图
按 Ctrl + Shift + C,拖选能给出报错上下文的区域。裁剪结果保留你的绘制内容,并在截图工作室中打开。给工单用的话,如果只想要纯裁剪、不要背景和边距,就关闭“边框”开关。
粘贴到工单里
点击“复制图片”,用 Ctrl + V 粘贴到 Jira、GitHub 或 Teams。如果你的工单系统只接受附件,就用“保存 PNG”,再把文件拖进去。
其余的用文字写
复现步骤、预期结果、实际结果、版本和环境。报错信息除了展示,也要复制成文本,这样才能被搜索到。
在各工具里怎么附上截图
| 工具 | 怎么附上 | 备注 |
|---|---|---|
| Jira Cloud | 把图片拖放或粘贴到工作项上 | 文件也可以放进评论和其他长文本字段 |
| GitHub Issues | 拖入、选择或粘贴到评论框 | 图片最大 10 MB |
| Microsoft Teams | 在聊天中用 Ctrl + V 粘贴,或用回形针附加 | 据 Microsoft 说明,直接粘贴到聊天中的图片不使用基于权限的共享 |
| Slack | 拖入消息框,或使用 + 按钮 | 一次最多 10 个文件 |
依据 Atlassian、GitHub、Microsoft 和 Slack 的文档,核实于 2026-10-03。
几秒钟就能画好箭头、方框和标签
像在出问题的应用上那样,在面板上画:在错误的值周围画个方框,再画一个带简短标签的箭头。
按住 Shift 画直线,Ctrl 画矩形,Ctrl + Shift 画箭头。
粘贴之前要做的,以及 Sincron 做不到的
检查是否含有客户数据
邮箱、电话号码、账号和网址中的令牌,会随截图一起传出去。把它们裁掉,或用不透明画笔盖住。模糊什么也保护不了:它可以被还原。
只在动态中才出现的 bug
Sincron 不录视频或 GIF。Windows 11 的截图工具可以用 Win + Shift + R 录屏。
很长的滚动页面
Sincron 只截取可见内容。要截整页,请用浏览器的整页截图或 ShareX。
没有链接,也没有云端
Sincron 不上传截图,也不生成分享链接。图片进入剪贴板或保存为 PNG,粘贴到哪里由你决定。
关于 bug 报告截图的常见问题
bug 报告的截图应该包含什么?
完整的报错信息、足以认出它出现位置的屏幕内容,以及问题上的一个标记。步骤、预期结果和版本写在工单文字里。
提 bug 用截图还是视频?
bug 是一种状态时用截图:报错信息、错误的值、错乱的版式。bug 取决于一系列操作或动画时用视频。在 Windows 11 上,截图工具可以用 Win + Shift + R 录屏。
怎么把截图粘贴到 Jira?
复制图片,用 Ctrl + V 粘贴到工作项上,或者把 PNG 文件拖进去。Jira Cloud 支持在工作项和评论里拖放或粘贴图片。
怎么隐藏工单截图里的客户数据?
裁剪到只剩报错部分,其余的用纯色方块盖住。在 Sincron 里,截图前在绘图图层中用黑色画笔、最大粗细涂盖。不要用模糊。
标注截图需要安装什么吗?
不一定。截图工具随 Windows 11 附带,Sincron 的“在线截图标注”工具在浏览器里运行。Sincron 应用能把流程压缩成两个快捷键,截图和标注免费。
另请参阅
提交下一个工单时,把 bug 标记好。
安装 Sincron Screen Tools:Ctrl + Shift + D 做标记,Ctrl + Shift + C 截图并粘贴。截图和标注免费、不限次数,也无需联网。