sublime text 不支持原生导出 pdf,所有相关插件均依赖外部工具如 highlight;推荐用 highlight 命令行工具,需正确安装字体、配置参数;高频需求建议改用 vs code 的 codesnap 或 printcode 插件。

Sublime Text 本身不支持导出 PDF
别折腾内置功能了——Sublime Text 没有原生导出 PDF 的菜单项、命令或插件接口。所有“一键导 PDF”的宣传,本质都是调用外部工具(比如 pygmentize + pdfkit,或 highlight + ps2pdf),再通过 Sublime 插件封装一层。直接在 Sublime 里按 Ctrl+Shift+P 搜 “export pdf” 看到的插件,背后全是这种间接链路。
常见错误现象:ExportPdf 插件报错 Command not found: wkhtmltopdf,或导出后中文全乱码、缩进错乱、主题失效——根本原因不是插件坏了,而是依赖没装对、字体没配好、或 HTML 中间层生成失败。
靠谱做法:用 highlight 命令行工具生成带语法高亮的 PDF
highlight 是轻量、跨平台、专为代码转文档设计的命令行工具,比基于 Webkit 的方案(如 wkhtmltopdf)更稳定,对中文、缩进、行号支持更好。它不依赖浏览器环境,也不吃内存。
- macOS 上用
brew install highlight;Windows 可下载二进制版,加到PATH - 确保系统已安装中文字体(如 macOS 用
STHeiti,Windows 用SimSun或Microsoft YaHei),否则中文显示为空方块 - 基础命令:
highlight --out-format=pdf --style=github --font-size=10 --line-numbers --page-width=210mm input.py -o output.pdf -
--style影响可读性:推荐github、atom-one-dark,避免用vim风格(背景色太深易烧眼) - 若要保留 Sublime 当前打开文件的内容,可写个简单 shell 脚本或批处理,用
$ST_FILE_PATH(需配合 Sublime 插件传参)或临时保存当前视图再调用
Sublime 插件只是胶水,别指望它自动搞定所有细节
像 ExportHtml 或 SublimeHighlight 这类插件,本质是把当前 buffer 保存为 HTML,再调外部命令转 PDF。它们无法绕过三类硬限制:
- 字体嵌入:HTML 转 PDF 时,
@font-face在wkhtmltopdf中默认被禁用,必须加--enable-local-file-access参数,且字体文件路径得绝对、可读 - 主题映射失真:Sublime 的
.sublime-color-scheme和highlight的--style不互通,改 Sublime 主题 ≠ 导出 PDF 样式同步变 - 宽屏代码折行:PDF 页面宽度固定,
highlight默认不折长行,超宽代码会直接溢出纸面——得加--wrap-simple或手动缩进
真正省事的替代方案:用 VS Code + CodeSnap 或 PrintCode
如果你导 PDF 频率高于每月一次,Sublime 这条链路维护成本偏高。VS Code 里 CodeSnap 插件能直接截图选区并导出 PNG/PDF,PrintCode 则走打印流,兼容系统级 PDF 打印机(macOS 的 “另存为 PDF”,Windows 的 Microsoft Print to PDF),避开了所有命令行依赖和字体配置。
关键区别在于:VS Code 的打印预览能看到真实分页、缩放、页眉页脚;而 Sublime + highlight 流程里,你只能靠反复试 --page-width 和 --margin 参数来逼近效果。
复杂点不在工具选型,而在字体路径、编码声明、行宽控制这三处——漏一个,PDF 就要么缺字,要么错页,要么看不清。别跳过验证步骤。










