直接截 Xcode 窗口是最容易想到的做法,效果却最差。截图会把屏幕上其他东西一并带上:光标、选中高亮、行号槽,还有编辑器的宽度——而不是你的代码需要的宽度。
改成复制文本。完整流程如下。
1. 复制代码,不是复制屏幕
在 Xcode 里选中代码,按 ⌘C。然后用 ⌘⇧V 粘贴进 Codeshot。
代码会被重新着色,Xcode 编辑器的状态一点都不会跟过来。没有光标,没有选中,没有行号槽的图标。只有代码。
顺带还解决了缩进。Xcode 默认用 Tab,而你粘贴到的很多地方会把一个 Tab 渲染得比你预期宽得多。从文本出发,样子就由你说了算。
2. 选主题
Codeshot 自带 Xcode 主题的浅色和深色版本。它和读者每天看的界面一致,是个稳妥的默认选择。
要换别的,理由通常是对比度。Xcode 的浅色主题偏柔和,在编辑器里原尺寸看没问题,一旦在信息流里被缩小就吃力了。如果图片会被小尺寸浏览,就挑对比度更高的主题。你可以在这里对比全部 30 款。
3. 精简
十到十五行差不多就是手机上还读得清的上限。整个文件不是。
复制之前把不相干的部分折叠起来,只留下能支撑你观点的内容。如果确实需要交代背景,顶部一行注释比周围二十行代码更管用。
4. 定尺寸并导出
让尺寸跟着内容走,或者锁定一个比例。16:9 这类宽比例能避免长行折行;3:4 这类高比例在代码较窄时更不浪费空间。
导出用 2× 或 3×,别用 1×,否则在 Retina 屏上会发虚。然后用 ⌘S 保存,或者用 ⌘⇧C 直接复制到剪贴板。
就这样
复制、选主题、精简、导出。主题和尺寸设好之后会保留,所以从第二张开始只要几秒钟。
Codeshot 完全在你的 Mac 上运行,不会上传你的代码。如果你要发的东西属于客户,或者来自尚未发布的版本,这一点很重要。
我们还有一个专门讲 Swift 的页面,附主题建议;如果你不是从 Xcode 过来的,可以看通用流程。