ExportHtml插件导出代码图需严格配置五项参数并完成三项手动操作:配置export_format、font_face、font_size、antialias、background_opacity;手动切换语法、保存文件、执行Export to Image命令;路径禁用中文空格,高分屏补dpi_scale,Chrome打印需勾选Background graphics并关闭页眉页脚。

ExportHtml 插件是目前最稳的方案,但装完不配参数=白装。直接截图或点错命令,结果必是黑底白字、字体发虚、行号错位、中文字体糊成一片。
ExportHtml 配置必须填满这五项
打开 Preferences → Package Settings → ExportHtml → Settings – User,粘贴以下最小必要配置(缺一不可):
-
"export_format": "png"(注意是双引号字符串,不是image_format) -
"font_face": "Fira Code"(必须是系统已安装的字体家族名,macOS 用fc-list :family查,Windows 看字体册显示全名) -
"font_size": 14(小于 12 在高分屏上基本不可读) -
"antialias": true(关了就锯齿,尤其 macOS Retina / Windows 缩放 125%+) -
"background_opacity": 0.95(深色主题下太低显灰蒙,太高像截图)
漏配 antialias 或用错 font_face 名称,导出图立刻边缘发虚;background_opacity 低于 0.9,深色主题背景会透出浏览器灰底。
导出前三个手动动作不能跳过
插件不会自动识别你的上下文,每一步都得人来确认:
- 点击右下角语法标识(如
Plain Text),手动切为Python或JavaScript;若识别错误,ExportHtml不报错但高亮全丢 - 确保文件已保存(
File → Save),未保存的 buffer 可能被忽略,导出空白或旧内容 - 执行命令时选
ExportHtml: Export to Image,别误点Export to HTML——后者只生成网页,不产图
导出后图糊/错位?检查这三个硬性条件
这不是插件 bug,而是 Sublime 渲染链和像素输出没对齐:
- 路径不能含中文或空格:
D:\My Projects\code.png会静默失败,改用D:\code\output.png - 加
"line_number_width": 40,否则长代码下行号列自动压缩,数字挤在一起 - 高分屏用户必须补
"dpi_scale": 1.25(对应系统缩放 125%),否则字体光栅化失准,再大字号也虚
Chrome 打印 HTML 为 PDF 时高亮变灰?
ExportHtml 导出的 HTML 文件本身可读性好,但直接双击用 Chrome 打开再打印,常出问题:
- 打印对话框里必须勾选
Background graphics(不勾就全灰) - 页眉页脚必须关掉(否则页码覆盖代码)
- 缩放选
100%或Fit,别用Shrink to fit(后者强制压缩字体导致锯齿) - 若中文字体仍发虚,在导出的 HTML 文件里搜
font-family,替换成:font-family: 'Fira Code', 'Microsoft YaHei', monospace;
真正麻烦的从来不是“怎么导出”,而是导出前那几处必须手动对齐的细节:语法切换、文件保存、路径字符、DPI 缩放值——少一个,图就废一半。


















