Sublime Text 本身不提供「导出 HTML」功能，所有带高亮的 HTML 文件都必须靠 ExportHtml 插件生成；需用 Package Control 安装正确名称的插件（ExportHtml，无数字、无空格），安装后部分 ST4 版本需重启，导出前须确保语法已设、文件已保存且编码为 UTF-8。
Sublime Text 本身不提供「导出 HTML」功能，所有带高亮的 HTML 文件都必须靠 ExportHtml 插件生成——别在菜单里找“Export as HTML”，它根本不存在。
怎么装 ExportHtml 插件才不报错
手动拖 ZIP、Git clone 或搜错名字（比如 Export HTML、ExportHtml2）都会失败。唯一可靠路径是用 Package Control：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Package Control: Install Package回车 - 搜
ExportHtml（结尾**不能有数字**，也不能带空格）回车安装 - 部分 Sublime Text 4 版本需重启才能在右键菜单看到
Export Html选项
如果导出后全是灰块或报 No module named 'pygments'，说明插件没走对依赖路径——别自己 pip install pygments，ExportHtml 自带轻量版着色器，启用 use_pygments 反而容易翻车，除非你明确需要 Pygments 风格（如 vs、monokai）且已全局配置好。
导出前必须手动确认的三件事
插件不会自动识别语言、编码或文件状态，以下任一条件不满足，HTML 打开就是纯文本或乱码：
立即学习“前端免费学习笔记（深入）”；
- 右下角状态栏必须显示具体语法（如
Python、JavaScript (Babel)），不是Plain text；点它手动选，别信文件后缀 - 文件必须已保存（即右上角没有 * 号），否则报
No file name - 编码必须是
UTF-8：菜单File → Save with Encoding → UTF-8；若仍乱码，导出后打开 HTML，把<meta charset=">改成<meta charset="utf-8">
导出 HTML 后浏览器里黑底白字/错位/折行异常
默认快捷键 Ctrl+Alt+X 走的是插件内置模板，但几个关键开关没调，就容易崩：
-
wrap_lines必须为false（默认值）：一旦开启，HTML 里会插入<wbr>或强制换行，导致fetch(url).then()被截断成两行，语义断裂 -
full_page必须为true：否则只输出<pre class="brush:php;toolbar:false;"><code></code></pre>，没<html>结构和内联样式，粘进 Word 或邮件直接丢色 - 深色主题（如
Monokai.sublime-color-scheme）导出后背景过暗？在Preferences → Package Settings → ExportHtml → Settings – User里加"light_theme": true强制浅色背景
导出 PNG / PDF 为什么截图糊、中文字体发虚
ExportHtml 的 export_format: "png" 不是真截图，而是生成 HTML 后调 Chrome 打印——所以字体、抗锯齿、背景透明度全得靠配置提前对齐：
- 必须在用户设置里显式填这五项：
"export_format": "png"、"font_face": "Fira Code"（系统已安装）、"font_size": 14（别用小数）、"antialias": true、"background_opacity": 0.95 - 导出命令必须选
ExportHtml: Export to Image，不是Export to HTML - Chrome 打印 PDF 时务必勾选
Background graphics，否则高亮全变灰；页眉页脚关掉，缩放选100%或Fit，别用Shrink to fit
最常被忽略的一点：中文字体失效不是插件问题，是导出的 HTML 里 font-family 没 fallback。打开生成的 HTML，搜 font-family，替换成 font-family: 'Fira Code', 'Microsoft YaHei', monospace; 就行。
