ExportHtml是Sublime Text 4唯一可靠导出带色HTML的插件，需通过Package Control安装wuub维护的版本；导出前须设好语法和UTF-8编码，中文乱码、背景过暗等问题均源于配置不当。
ExportHtml插件是唯一可靠路径
Sublime Text 本身没有导出带颜色 HTML 的能力，所谓“导出染色代码”，本质是把当前 syntax highlighting 渲染结果转成内联 CSS 写进 <pre class="brush:php;toolbar:false;"><code></code> 块里。不装插件，Ctrl+C 粘贴到任何地方都是纯文本——这是最常被忽略的前提。</pre>
必须用 ExportHtml（不是 ExportHtml2，后者已停更且不兼容 ST4），它是目前唯一仍在维护、支持 Sublime Text 4、能正确映射主题配色与语法作用域的插件。安装后右键菜单即出现 Export Html，无需记忆命令。
- 通过
Package Control: Install Package搜索并安装ExportHtml，安装完重启 Sublime - 导出前务必确认当前视图已设置语法（
View → Syntax → Python等），否则按纯文本处理 - 若文件未保存（显示为
untitled），插件会报错No file name，先Ctrl+S
Copy as HTML适合快速粘贴片段
如果你只要几行代码嵌入 Notion、邮件或博客正文，不需要完整 HTML 文档结构（比如没 、），Copy as HTML 更轻量。
它输出的是一个带内联 style 的 <div class="highlight">
<pre class="brush:php;toolbar:false;"><code></code> 片段，Ctrl+V 就能用。但要注意：它不依赖当前 <code>color_scheme</code> 文件，而是做颜色近似映射，对自定义主题兼容性弱；粘贴到 GitHub README 或微信公众号这类不执行 CSS 的环境，高亮直接消失。<p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记（深入）</a>”；</p>
</pre>
<ul>
<li>只处理可见文本，不保留折叠区域、书签、光标位置</li>
<li>不转义 HTML 特殊字符（如代码含 <code><div>），可能破坏目标页面结构
<li>中文显示正常，但字体继承目标环境默认字体，无法指定 <code>'Microsoft YaHei' 等
导出后中文乱码或背景过暗怎么调
导出 HTML 后打开发现中文方块、背景漆黑或文字发灰，不是编码问题就是主题适配没到位。
中文乱码几乎全是 Sublime 自身编码设置导致：必须手动设为 UTF-8（File → Save with Encoding → UTF-8），ExportHtml 插件不负责编码转换。深色主题（如 Monokai.sublime-color-scheme）导出后背景太暗，是因为插件默认复用编辑器主题的背景色——可在插件 Settings – User 中加 "light_theme": true 强制浅色背景。
- 检查
Preferences → Settings – User是否有"color_scheme"字段，路径写错（如漏掉Packages/）会导致高亮全灰 - 新版本主题多为
.sublime-color-scheme（JSON 格式），部分老插件兼容性差；临时切回Monokai.tmTheme可验证是否主题格式问题 - 导出时勾选
Inline CSS，否则样式外链，离线打开就变白底黑字
别碰 sublimetext-html-export 这类老插件
搜索结果里还能看到 sublimetext-html-export、ExportHtml2 等名字，它们全部停止更新，且明确不兼容 Sublime Text 4。装了不仅导出失败，还可能引发插件冲突或菜单消失。
尤其注意 ExportHtml2：名字像升级版，实为废弃分支，GitHub 最后提交在 2021 年，ST4 下无法加载 color scheme，导出结果必丢色。官方推荐路径只有 ExportHtml 主仓库（作者为 wuub，持续维护至 2026 年）。
- 安装前确认 Package Control 列表中显示的作者是
wuub，不是sublimetext-plugins或其他 - 不要试图用 Pygments 替代——它脱离 Sublime 主题，渲染逻辑不同，括号匹配、自定义 scope 高亮全丢失
- 截图、在线工具、Word 手动着色等方案，都绕不开失真、不可搜索、放大模糊这三个硬伤
真正容易被忽略的点是：导出效果完全绑定当前打开文件的语法类型和 color_scheme 设置，换主题或改语法后必须重新导出，插件不会自动同步变更。
