Sublime Text 导出高亮 HTML 必须安装 ExportHtml 插件，配置 pygments、语言识别和主题适配，再通过 Chrome 打印转 PDF；其他插件或设置不当会导致样式丢失、乱码或黑屏。
Sublime Text 本身不提供导出 HTML 的功能，所谓“导出带高亮的 HTML”，全靠插件把当前语法高亮效果转成内联 CSS 写进 HTML 文件——没插件，就只有纯文本。
必须装 ExportHtml，别试 Copy as HTML 或老插件
ExportHtml 是目前唯一稳定支持 Sublime Text 4、持续更新、能正确映射 color_scheme 颜色并生成完整 HTML 文档结构的插件。Copy as HTML 只输出无 <body> 的 <div class="highlight"> 片段，粘到 Notion、语雀或邮件里极易样式丢失；sublimetext-html-export 这类 2015 年停更的老插件，在 ST4 上会直接报 ImportError: No module named 'urllib2'。
- 安装路径：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）→ 输入Package Control: Install Package→ 搜ExportHtml（结尾**不能有数字**）→ 回车 - 装完必须重启 Sublime，否则右键菜单不出现
Export Html选项 - 别手动 clone GitHub 仓库——路径错位、Python 环境混用、缺
pygments都会导致导出后全灰或白屏
导出前三件事没做，HTML 打开就是乱码或黑底白字
导出效果不是“点了就完事”，它强依赖当前视图状态和插件配置：
- 右下角状态栏必须显示具体语言（如
Python、JavaScript），不是Plain text；否则插件按纯文本处理，无任何高亮 - 执行
Preferences → Package Settings → ExportHtml → Settings – User，填入启用pygments的配置：{ "use_pygments": true, "pygments_style": "default", "line_numbers": false, "wrap_lines": false } - 终端运行
pip install pygments（Windows/macOS 均适用；macOS 权限错误时加--user）
导出后中文糊、行号错位、背景全黑？检查这三项
生成的 HTML 在浏览器里打开异常，问题通常不在插件本身，而在输出参数与环境不匹配：
Article To Html
下载
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
立即学习“前端免费学习笔记（深入）”；
- 中文发虚或成方块：打开生成的 HTML 文件，找到
<style>块里的font-family，改成font-family: 'Fira Code', 'Consolas', 'Microsoft YaHei', 'STHeiti', monospace; - 行号挤占代码宽度：导出配置里关掉
include_line_numbers；编辑器原生行号更准，也避免 PDF 打印时折行错乱 - 背景黑但文字也是黑的：说明当前主题是暗色系（如
Monokai.sublime-color-scheme），但插件默认用了浅色 CSS；在 ExportHtml 设置中加"light_theme": true强制浅色背景，或改用html_style: "inline_dark"
想导出 PDF？别信“一键导出”，先过 Chrome 打印关
Sublime 没有原生 PDF 导出，所有“导出 PDF”本质都是 HTML + 浏览器打印。关键不是怎么导，而是怎么让打印结果不翻车：
- 导出时务必勾选
full_page，否则只生成<pre><code>块，无 CSS 样式，打印出来就是黑底白字 - 用 Chrome 打开生成的 HTML，按
Ctrl+P→ 目标选「另存为 PDF」→ 关闭页眉页脚、勾选「背景图形」、缩放设为「100%」 - Safari / Firefox 不推荐：对
@media print支持弱，高亮色块常变浅甚至消失 - 如果打印后中文仍模糊，Chrome 打印设置里**关掉「背景图形」**，反而能提升中文字体抗锯齿效果
真正容易被忽略的是：同一份代码，在不同 color_scheme 下导出的 HTML 渲染效果可能完全不同，而且无法预览——你得导一次、开一次、调一次。导出不是终点，而是调试链的第一环。
