Sublime Text 无原生代码截图功能,依赖插件实现;CodeScreenshot 需 GPU 加速、合规路径、显式缩放;ExportHtml 更稳定但需正确配置格式与 DPI;pygmentize 命令行最可控;所有插件均无法捕获括号高亮等动态状态。

Sublime Text 本身不支持代码截图导出,所谓“截图”全是靠插件调用外部渲染或模拟流程实现的——没有原生能力,硬装错插件只会黑图、报错、中文乱码。
CodeScreenshot 插件为什么导出失败?
它依赖 GPU 渲染 + 文件路径合规 + 显式缩放配置,缺一不可。常见失败现象包括:导出后是纯黑图、报 IOError: [Errno 2] No such file or directory、生成空 PNG、控制台无提示但文件没出现。
- 必须启用 GPU 加速:
Preferences → Settings中确认"hardware_acceleration": "gpu"(设为"none"就必然黑图) - 未保存的 buffer 不参与渲染——哪怕新建文件只写一行,也得先按
Ctrl+S - 导出路径不能含中文或空格;比如
D:\My Projects\code.png会静默失败,应改为D:\code\output.png - 缩放不匹配导致字体模糊:若系统缩放是 125%,需在
Preferences → Package Settings → CodeScreenshot → Settings里加"scale_factor": 125
ExportHtml 导出 PNG 图片更稳,但要注意三处关键配置
它不调外部命令,直接基于 Sublime 渲染引擎生成像素图,适配 ST4,成功率远高于 CodeScreenshot,但默认配置容易踩坑。
- 必须设
"image_format": "png"和"image_quality": 100,否则可能输出低质 JPEG 或模糊 PNG - 行号和字体大小要显式控制:
"line_numbers": true、"font_size": 14(小于 12 在高分屏上基本看不清) - Windows 高缩放用户必须补
"dpi_scale": 1.25(对应系统设置 125%),否则文字发虚、边距错位 - 执行时选
ExportHtml: Export to Image,不是Export to HTML——后者输出的是网页,不是图
不想装插件?用 pygmentize 命令行直出,可控性最强
绕过 Sublime GUI 层,直接用 Pygments 渲染,适合批量处理、CI 集成或对样式有强要求的场景。它不依赖编辑器当前主题,但需手动对齐风格。
- 安装:
pip install Pygments(确保 Pillow 也已装,否则报PIL/Pillow library错) - 基础命令:
pygmentize -f png -O style=dracula,font_name="Fira Code",font_size=14,linenos=1 -o out.png main.py -
style参数必须与 Sublime 当前主题语义一致(如dracula、monokai、github-dark),否则颜色失真 - 中文显示异常?在
-O后加font_name="Sarasa Mono SC"(macOS/Windows 均可用),并确认该字体已系统级安装 - 长代码横向溢出?加
line_length=80或改用-f svg输出矢量图,再转 PNG
真正容易被忽略的是:所有插件导出的“代码图”,都不包含 Sublime 特有状态——比如括号匹配高亮、自定义作用域着色、折叠区域图标、光标位置。如果你截图是为了演示交互逻辑,这些信息全丢了。这时候不如直接录屏,或者换 VSCode + CodeSnap ——它真能截到渲染引擎里的每一像素。











