为什么又写一篇截图工具
程序员每天要用截图的地方，比想象中多：
- 提 Bug 要贴复现步骤和报错；
- Code Review 要标出"这里少了一个判空"；
- 写接口文档要把返回示例贴进去；
- 给新人做交接，要一步一步录下来；
- 从日志、虚拟机、远程桌面里抠一段文字，懒得手打。
系统自带的截图能解决"截"，但解决不了"截完之后"：画箭头要开预览，打码要开 PS，录屏要开 OBS，做教程要一张张截图再排版。工具换得越多，心流断得越频繁。
这篇文章记录我现在的做法：用 InSnap 把截图、标注、OCR、长截图、贴图、录屏和操作指南串成一条流水线。它支持 macOS 14.4+ 和 Windows 10+，两个系统同一套快捷键；没有 Linux 版，Linux 用户可以先把流程拿走，工具另选。
一、Bug 报告：一张图说清复现步骤
1. 截图 + 箭头 + 序号
按下截图快捷键（Mac 是⌘1，Windows 是Ctrl+1），框选出问题的区域，然后直接在工具条上画：
- 箭头指向出错的按钮或字段；
- 序号 1、2、3 标出操作顺序；
- 文本框写"这里应该显示 200，实际是 500"。
序号有个细节很实用：选中一个序号后按A可以输入说明，改序号时后面的序号会自动顺延。写多步复现时不用手动改编号。
2. 用长截图装下整段日志
报错堆栈、慢查询日志、一屏放不下的调用链，用长截图：框住日志区域，点工具条上的"长截图"，然后正常滚动。右侧预览会随着拼接实时变长，滚完按 Enter 完成。
不用把日志复制到编辑器再截，也不用拼三张图。
3. 敏感信息先处理
接口地址里的 token、数据库连接串、客户手机号，分享前必须打码。
我的选择标准很简单：
- token、密码、密钥：纯色遮盖，或者直接裁掉；
- 客户姓名、手机号：高强度马赛克；
- 无关的侧边栏、书签栏：裁掉。
模糊看着最"美观"，但保护力最弱，尤其是字号大的文字。涉及密钥的截图，不要用模糊。
4. 附一份能复现的模板
截图之外，我会在 issue 里贴一段固定模板：
## 环境 - OS: macOS 14.4 / Windows 11 23H2 - App 版本: 1.2.3 (build 456) - 浏览器 / 运行时: Chrome 155 / Node 24 ## 复现步骤 1. 打开设置 → 通知 2. 关闭 Email alerts 3. 刷新页面 ## 预期 / 实际 - 预期：开关保持关闭 - 实际：刷新后恢复开启 ## 附件 - 截图：见上（序号 1-3） - 录屏：screen-recording.mp4 - 控制台日志：见长截图截图负责"看得见"，模板负责"能复现"，两者缺一不可。
二、Code Review：前后对比和贴图对照
Review 别人的 PR 时，最常说的是"这里改一下"，但文字描述往往不如一张对比图。
我的做法：
- 截改之前的界面 / 输出；
- 截改之后的；
- 用图片编辑页把两张图拼在一起，或者分别贴出来；
- 在 PR 评论里贴图 + 一句结论。
InSnap 的贴图可以让截图悬浮在所有窗口之上：左边放设计稿，右边写代码；或者把接口返回贴在 Postman 旁边，对照字段。滚轮缩放、⌘/Ctrl+ 滚轮调透明度，点击穿透打开后完全不挡操作。
如果团队用飞书 / Slack，图片附件容易过期；InSnap 的 Cloud 可以把截图上传成带有效期和密码的链接（可选订阅，和 Pro 相互独立）。如果只是本地协作，保存成文件附在 PR 里就够了。
三、查资料、写文档：OCR 和贴图
1. 从截图里复制报错
搜报错时最烦的是错误信息在图片里。InSnap 的 OCR 可以在截图界面上直接选字：
- 框选报错区域；
- 点工具条上的OCR；
- 在图上拖选需要的行，或者直接全选；
⌘C/Ctrl+C复制。
识别在本机完成，图片不上传，断网也能用。中文、英文和常见的拉丁字母语言效果不错；日文假名、韩文和俄文目前不可靠，这几种语言建议用专门的 OCR。
2. 把命令和配置贴在旁边
调试时经常要对照一段配置、一串命令、一个 JSON。InSnap 的"贴图剪贴板"不只能贴图片：复制的纯文本会渲染成一张易读的卡片贴在屏幕上，Markdown、HTML 富文本也能保留基本格式。
对开发者来说，这比开一个记事本窗口轻得多。
3. 截图历史能搜图中文字
截图历史默认保留，支持按应用、标签、收藏筛选，也能搜索 OCR 索引过的图中文字。找"上周那个报错截图"时，直接搜错误码就行，不用翻文件夹。
四、做教程和交接：录屏 + 操作指南
1. 录屏自动缩放
给新人演示或者提 PR 附演示视频时，整屏录制的信息量太低：任务栏、聊天窗口、浏览器标签全在画面里，观众得自己找光标。
用"录制并编辑"模式录完，视频编辑器会根据点击和光标位置自动生成缩放段：操作时推近，移动时跟拍。强度有轻 / 中 / 强三档，时间轴上每一段都能单独删改。
自动缩放是 Pro 功能；免费版可以录 MP4（支持系统声音、麦克风和摄像头），日常发个短演示够用。
2. 点几下自动生成图文指南
写新人文档、SOP、接口联调步骤时，最耗时的不是写，而是截图、裁剪、加箭头、排版。
InSnap 的操作指南换了个思路：开始录制，正常把任务做一遍，每次点击自动变成一个步骤——点击前一刻的截图、点击位置的红圈、从按钮名称生成的标题。停止后进入编辑器，改标题、补说明、调顺序、加子步骤和提示块。
还可以一键给所有步骤的同一区域打码，导出成 PDF、Word、PowerPoint、HTML、Markdown、SCORM 或 JSON。给团队知识库用 Markdown，给培训系统用 SCORM，给客户用 PDF。
五、我的快捷键和设置
两个全局快捷键就够：
| 动作 | Mac | Windows |
|---|---|---|
| 截图 | ⌘1 | Ctrl+1 |
| 贴图剪贴板 | ⌘2 | Ctrl+2 |
其余动作（长截图、录屏、操作指南、历史）在设置里按需绑定。截图界面内还有⌘A全屏、⌘C复制、⌘S保存、⌘Z撤销等内置快捷键。
值得打开的设置：
- 自动识别窗口 / 界面元素：悬停就能框住窗口或按钮，不用手动对齐；
- 截图历史：默认开，支持搜索；
- 记录截图所在网页的网址：排查线上问题时很有用（需要辅助功能授权）；
- 输出选项：Retina 缩放到 1x、加 1px 边框，发文档更整齐。
六、边界：它不适合谁
为了避免写成软文，这几点必须说清楚：
- 没有 Linux 版。Windows 和 macOS 用户是目标用户，Linux 只能另选工具。
- OCR 对日文假名、韩文、俄文不可靠，这是模型字典的限制，不是设置问题。
- 智能擦除是本地算法，在纯色、渐变、界面类背景上效果好；主体和背景颜色特别接近时可能擦不干净，复杂照片不要期待 PS 级效果。
- 自动缩放、长截图、GIF、操作指南、智能擦除属于 Pro；截图、标注、贴图、OCR、历史和基础录屏免费。
- 分享链接属于 Cloud，是独立于 Pro 的可选订阅；不需要链接的话，保存本地附件完全够用。
最后
工具的价值不在于功能列表有多长，而在于它能不能让"截图 → 标注 → 分享 → 写文档"这几步不打断思路。
如果你现在的流程是：系统截图 → 预览画箭头 → 微信传图 → 再开一个录屏软件，那值得试一次把流程收进一个工具里。免费版已经包含截图、标注、贴图、OCR、历史和基础录屏，先把最常用的三个动作跑一遍，再决定要不要 Pro。
官网（Mac 与 Windows）：https://insnap.app
关于 InSnap：面向 Mac 和 Windows 的截图、录屏与操作指南工具。截图、标注、贴图、OCR 免费；Pro 一次性买断，Cloud 为可选订阅。
