代码截图不是「截屏」。截屏会带上编辑器主题、侧栏、通知和像素噪点;一张好的代码图应该只保留代码、行号和一个安静的窗口边框,让读者先看到逻辑,而不是你的桌面。
1. 先确定用在哪里
发在聊天工具里的图,宽度 800–1200px 就够了;放进文档或幻灯片,建议按 2× 导出,避免放大后发虚;发在社交平台,正方形或 4:3 更容易占满预览。先想清楚用途,再决定字号和内边距,不要导出后再反复裁。
2. 语言和主题要服务于内容
TypeScript、JSON、SQL 的关键字和字符串颜色不同,选错语言会让高亮失真。深色主题适合技术分享和夜间阅读,浅色主题更适合打印和文档。主题不是越花越好:背景和代码的对比度要够,注释不能淡到看不见。
3. 窗口栏、行号和标题
窗口栏能快速传达「这是一段代码」,但会占掉一点垂直空间;行号方便别人指出「第 12 行」,代码很短时可以关掉。窗口标题写文件名或函数名,比写「Untitled」更有信息量。不要把公司名、内部项目名或工单号放进标题。
4. 截图前先脱敏
代码里经常藏着 token、内部域名、用户手机号和数据库连接串。导出前搜索一遍 token、secret、password、@ 和公司内网域名。即使工具承诺本地处理,截图一旦发出去就无法收回。
5. 导出与检查
优先导出 2× PNG:文字边缘更干净,放到 Retina 屏幕或 PPT 里不会糊。导出后放大到 100% 看三件事:最长的一行有没有被裁掉、行号和代码是否对齐、深色背景上的注释是否还看得清。代码太长时,宁可分成两张图,也不要把字号压到 10px。
三个常见错误
- 整屏截图:带上侧栏、终端和通知,信息噪音太大;
- 对比度不足:浅灰注释配深灰背景,投影后几乎看不见;
- 直接拉伸:把 600px 宽的图放大到 1600px,文字会发虚。