Sublime如何实现代码截图？使用Sublime插件生成漂亮代码图
Sublime 本身不支持代码截图，插件只是生成 HTML + CSS 后用浏览器转图
这里有个常见的误解需要先澄清：Sublime Text 本身是一个纯粹的文本编辑器，它并没有内置任何渲染引擎。所以，所有那些声称能实现“代码截图”的插件，无论是 CodeScreenshot 还是其他，其底层逻辑都是一样的。它们本质上做了两件事：首先，将你选中的代码，连同当前编辑器的配色方案（主题），转换成一份带有完整样式的 HTML 文档；然后，在后台悄悄地调用一个无头浏览器（比如 Chromium），让这个浏览器去渲染这份 HTML，并最终截取屏幕快照，保存为图片。你最终看到的那张“漂亮的代码图”，其实是一张浏览器快照。
推荐方案：用 CodeScreenshot 插件 + Chromium headless
目前来看，CodeScreenshot 插件配合 Chromium 无头模式，是稳定性最高、样式也最可控的方案。不过，有件事必须提前说明：这个插件本身并不包含截图引擎，它需要你手动配置一个浏览器路径。具体操作步骤并不复杂：
- 第一步，安装插件。通过 Sublime 的
Package Control，搜索并安装CodeScreenshot。 - 第二步，确保你的系统里已经安装了 Chromium 或 Chrome 浏览器。在 macOS 上，用
brew install chromium命令安装会很方便；在 Windows 上，则需要确认chrome.exe的路径是否已加入系统环境变量，或者稍后手动指定。 - 第三步，进行关键配置。打开 Sublime Text，进入
Preferences → Package Settings → CodeScreenshot → Settings，在用户设置文件中填入类似下面的配置：
{
"browser_path": "/opt/homebrew/bin/chromium",
"theme": "Monokai",
"font_size": 14,
"padding": 32,
"line_numbers": true
}
- 最后，选中你想要截图的代码，右键点击，选择
Capture Code Screenshot，插件就会自动生成 PNG 图片文件了。
常见失败原因和绕过方法
很多朋友在配置时会遇到报错，比如 Browser not found，或者生成了空白图片。这通常不是插件本身的问题，而是环境链路中的某个环节断了。下面这几个坑，值得你特别注意：
- 浏览器路径不对：
browser_path必须指向一个可执行的二进制文件（例如/usr/bin/chromium）。在 macOS 上，千万别填成应用程序包（App Bundle）的路径，比如/Applications/Chromium.app，这是无效的。 - Linux 下的沙箱权限问题：如果在 Linux 系统上遇到类似
Failed to move to new namespace的错误，这通常是因为缺少沙箱权限。解决方法是在配置里添加额外的浏览器参数："browser_args": ["--no-sandbox", "--disable-gpu"]。 - 中文注释乱码：如果截图里的中文注释变成了乱码，请先检查源文件的编码。确保它是
UTF-8 with BOM格式。在 Sublime 中，你可以直接点击编辑器右下角的编码名称，选择Convert to UTF-8进行转换。 - 主题颜色不生效：插件会读取 Sublime 当前使用的配色方案名称。但有些第三方主题（比如
Dracula）的内部名称可能与实际文件名不一致，导致插件无法正确匹配。如果遇到这个问题，可以临时将 Sublime 的主题切换回内置的Monokai来测试一下。
替代思路：不用插件，用命令行快速生成
如果你只是偶尔需要导出代码图片，或者你的代码片段已经保存在文件里了，那么完全不用依赖 Sublime 插件。直接用命令行工具组合，反而更轻量、更灵活：
- 首先，安装必要的 Python 库：
pip install Pygments weasyprint。 - 然后，使用
pygmentize将代码高亮并生成 HTML 文件：pygmentize -f html -O full,style=vs,linenos=1 example.py > out.html。 - 最后，用
weasyprint将 HTML 转换成 PNG 图片：weasyprint out.html out.png（注意，输出 PNG 格式可能需要额外安装 Cairo 库）。
这个方法的优点是彻底脱离了 Sublime 环境，非常适合在持续集成（CI）流程中或者进行批量处理。当然，缺点也很明显：它无法实时截取你在 Sublime 编辑器中选中的代码范围，你需要先将代码保存到临时文件里。
说到底，实现代码截图功能本身并不复杂。真正让人卡住的，往往不是“怎么点菜单”，而是那些琐碎的环境配置细节——浏览器路径写错了、字体没加载成功、或者 Sublime 的主题名和插件预期的不一致。这些细节，恰恰是功能能否顺利落地的关键。
