Sublime Text需通过CodeScreenshot等第三方插件导出高亮代码图,安装前须配置Package Control、启用GPU硬件加速、保存文件且路径无中文或空格;字体模糊需匹配ui_scale并确保字体已安装;高级样式如透明背景、圆角、阴影需修改插件源码或导出后用magick/ffmpeg处理。

Sublime 没有原生代码截图功能,得靠第三方插件实现
Sublime Text 本身不提供“导出带高亮的代码图片”能力,所谓“代码截图插件”,实际是通过 Package Control 安装的第三方工具(比如 CodeScreenshot 或 SublimeCodeIntel 配合外部脚本),本质是把当前视图渲染成 PNG。别被“截图”二字误导——它不是截屏幕,而是生成带主题配色、行号、字体抗锯齿的静态图。
推荐用 CodeScreenshot,但安装后默认不工作
这个插件最轻量,适配 Sublime Text 4,但有几个硬性前提必须手动满足:
- 必须已安装
Package Control(没装就先装,否则搜不到插件) - 必须在 Sublime 中启用
hardware_acceleration:打开Preferences → Settings,确保"hardware_acceleration": "gpu"或"opengl"(设为"none"会导致导出黑图) - 导出前要先保存文件(哪怕空文件也要
Ctrl+S),未保存的 buffer 无法渲染 - 导出路径不能含中文或空格,否则生成失败且无提示,错误日志藏在
Sublime Text Console(Ctrl+`)里,报错类似IOError: [Errno 2] No such file or directory
CodeScreenshot 导出时字体模糊?调对 DPI 和缩放比例
生成图文字发虚,90% 是因为没匹配编辑器当前显示缩放。插件默认按 1.0 倍缩放渲染,但你可能开了 125% 或 150% 缩放(Windows 设置或 Sublime 的 ui_scale)。解决方法:
- 查当前缩放:打开
Preferences → Settings,看有没有"ui_scale",值是1.25就填125,1.5就填150 - 改插件配置:菜单栏
Preferences → Package Settings → CodeScreenshot → Settings,加一行"scale_factor": 125 - 字体仍糊?换等宽字体:插件只认系统已安装的字体,
"font_face": "Fira Code"要确保本机真装了,不然 fallback 到 Courier New,效果差很多
导出带背景透明/圆角/阴影?得手动改插件源码
CodeScreenshot 默认输出纯白背景、直角、无阴影的图,想加这些效果,必须改它的 Python 文件(路径类似 Packages/CodeScreenshot/screenshot.py)。关键点:
- 背景透明:找到
image = Image.new("RGB", size, "white"),改成Image.new("RGBA", size, (0,0,0,0)) - 圆角:得用 PIL 的
ImageRounder类,但原插件没集成,需额外加 10 行代码裁剪 mask - 阴影:没有现成参数,得在绘图层叠加偏移的灰色矩形,还要控制 opacity,容易让导出变慢
- 改完必须重启 Sublime,且每次升级插件都会覆盖你的修改——这不是 bug,是设计如此
真正稳定的做法是导出后用 magick 或 ffmpeg 后处理,比硬改插件靠谱。









