Sublime Text 需通过 ExportHtml 插件导出带语法高亮的 HTML;推荐用 Package Control 安装,配置 "renderer": "pygments" 和 "pygments_theme": "monokai",并确保文件已设正确语法、系统已安装 pygments 包。

Sublime Text 本身不支持直接导出带语法高亮的 HTML,必须依赖插件;ExportHtml 是目前最稳定、可定制性强的选择,但安装和配置稍有门槛,容易卡在权限、路径或编码上。
怎么安装 ExportHtml 插件
推荐用 Package Control 安装,避免手动下载解压出错:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),调出命令面板 - 输入
Package Control: Install Package并回车 - 等待列表加载完成,输入
ExportHtml,选中后回车 - 安装完成后重启 Sublime(部分版本需重启才生效)
如果命令面板里搜不到 ExportHtml,说明 Package Control 未正确安装或网络受限,此时不要手动 clone 仓库——ExportHtml 依赖 pygments,手动安装易因 Python 环境不一致导致导出无颜色或报错 ImportError: No module named pygments。
导出带颜色的 HTML 要改哪些设置
默认导出是黑白的,关键在启用 pygments 渲染器并指定主题:
立即学习“前端免费学习笔记(深入)”;
- 打开
Preferences → Package Settings → ExportHtml → Settings – User - 填入以下最小必要配置:
{
"renderer": "pygments",
"pygments_theme": "monokai"
}
monokai 是 Sublime 默认配色之一,兼容性好;其他可用值包括 default、vs、emacs(注意不是 Sublime 的 color scheme 名,而是 Pygments 内置主题名)
如果导出后仍是灰底黑字,检查:"renderer" 拼写是否为 "pygments"(不是 "Pygments" 或 "pygment"),且没被注释掉。
导出时常见颜色丢失原因
即使设置了 pygments,仍可能没颜色,典型原因有:
- 当前文件没设置语法类型:右下角显示
Plain Text时,ExportHtml不会高亮——先点击右下角,选对应语言如Python、JavaScript - 用了非标准语法定义(比如自定义的
.sublime-syntax文件),而 Pygments 不识别该语言名,会 fallback 到纯文本 - 导出范围选了
Selection但选区为空,或只选了空行——插件会静默生成无高亮的 HTML - 系统没装
pygmentsPython 包:终端执行python -c "import pygments; print(pygments.__version__)",若报错需运行pip install pygments(注意 Sublime 内置 Python 和系统 Python 可能不同,优先用 Sublime 所在环境)
导出命令在哪调用
安装并配置完后,导出操作本身很简单:
- 打开要导出的代码文件(确保右下角已设对语法)
- 按
Ctrl+Shift+P,输入ExportHtml - 选择
ExportHtml: Export(不是ExportHtml: Export Selection,除非你只要选中部分) - 在弹出的保存对话框中选路径,文件名建议加
.html后缀
生成的 HTML 默认含内联 CSS,打开即见颜色;如果浏览器里看到乱码,说明文件保存编码不是 UTF-8——在 Sublime 导出对话框底部确认编码为 UTF-8,别选 UTF-8 with BOM,后者会导致 IE/Edge 解析异常。










