必须用ExportHtml插件导出带高亮HTML,因其是唯一稳定支持Sublime Text 4、正确映射主题色与语法作用域的方案;安装需通过Package Control、重启生效,导出前须确认语法设置、UTF-8编码及文件已保存。

Sublime Text 没有叫 “Print to HTML” 的官方或主流插件——你搜到的大概率是过时、命名混淆或已失效的旧插件,直接装会报错或导出空白/黑屏。真正能稳定生成带高亮 HTML 的,只有 ExportHtml 插件。它不是“打印”,而是把当前视图的语法高亮实时映射为内联 CSS 的完整 HTML 文件。
为什么找不到 Print to HTML 插件?
Sublime Text 官方仓库和 Package Control 中不存在名为 Print to HTML 的维护中插件。搜索结果里出现的,多是以下几种情况:
- 老版本(ST2/ST3)停更插件,如
sublimetext-html-export,在 ST4 上会抛出ImportError: No module named 'urllib2' - 名字近似但功能不符的插件,比如
Copy as HTML,它只输出无<html>结构的<div class="highlight">片段,粘贴到 Notion、语雀或邮件里极易丢样式 - 用户自建或未上架的非标脚本,路径、Python 环境、依赖(如 pygments)稍有错位就全灰或白屏
必须用 ExportHtml:安装与启动验证
装完不重启,右键菜单不会出现 Export Html 选项;不重启,命令面板也搜不到 ExportHtml: To File。
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入Package Control: Install Package回车 - 搜
ExportHtml(结尾不能有数字,别选ExportHtml2或Export HTML) - 安装完成后必须重启 Sublime Text,否则插件不加载
- 重启后,右键编辑区应出现
Export Html菜单项;命令面板输入ExportHtml也能看到多个导出命令
导出前必须手动确认的三件事
插件不会读文件后缀,也不会猜你写的是什么——它只认当前视图的 syntax 设置和编码。设错就导出纯文本。
立即学习“前端免费学习笔记(深入)”;
- 右下角状态栏必须显示具体语言,如
Python、JavaScript (Babel)、Markdown;若显示Plain text,点击它并手动选对语法 - 菜单
File → Save with Encoding必须是UTF-8(不是UTF-8 with BOM),否则中文显示为方块或乱码 - 文件必须已保存(
File → Save),否则插件报错No file name,导出中断
导出命令选哪个?To File 是唯一推荐路径
ExportHtml: To Clipboard 和快捷键 Ctrl+Alt+X 默认走简配模式,极易翻车:行号错位、背景过暗、长行被无脑折断、甚至 <div> 标签被当代码渲染出来。
- 务必用
ExportHtml: To File(右键菜单或命令面板调用) - 弹出保存对话框时,后缀必须是
.html(如script.py.html),否则浏览器无法识别 MIME 类型 - 导出后立刻用 Chrome/Firefox 打开验证:是否带行号?背景色是否匹配主题?中文是否正常?
<pre><code>是否完整包裹?
最容易被忽略的点:导出效果完全绑定当前 color scheme 和 syntax 设置——换主题或改语言后,必须重新导出;HTML 里没有动态链接,所有样式都是内联写死的,改了 Sublime 主题不会自动更新已导出的 HTML 文件。



















