Sublime Text 本身不支持代码截图,所有插件均通过生成带样式的 HTML 并调用浏览器(如 Chromium headless)截取渲染结果实现;推荐 CodeScreenshot 插件配合手动配置浏览器路径与参数,注意编码、主题名匹配及沙箱权限等细节。

Sublime 本身不支持代码截图,插件只是生成 HTML + CSS 后用浏览器转图
Sublime Text 是纯文本编辑器,没有内置渲染引擎,所有“代码截图”插件(如 CodeScreenshot、SublimeCodeIntel 配合导出脚本)本质都是:先高亮代码为带样式的 HTML,再调用系统命令(如 wkhtmltopdf、chromium --headless)或 Python 库(如 weasyprint、playwright)截取渲染结果。你看到的“漂亮图片”,其实是浏览器快照。
推荐方案:用 CodeScreenshot 插件 + Chromium headless
这是目前最稳定、样式可控的方式。注意它不自带截图引擎,需手动配置浏览器路径:
- 安装插件:
Package Control → Install Package → CodeScreenshot - 确保系统已安装 Chromium 或 Chrome(macOS 建议用
brew install chromium;Windows 下确认chrome.exe在 PATH 或手动指定路径) - 在 Sublime 的
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),不是桌面快捷方式或 App Bundle(macOS 上别填/Applications/Chromium.app) - Linux 下若提示
Failed to move to new namespace,说明缺少沙箱权限,加参数:"browser_args": ["--no-sandbox", "--disable-gpu"] - 中文注释乱码?确保源文件编码是
UTF-8 with BOM(Sublime 中右下角点击编码 → Convert to UTF-8) - 主题颜色不生效?插件只读取 Sublime 当前配色方案名,但部分第三方主题(如
Dracula)名字与实际文件名不一致,可临时切换成内置主题Monokai测试
替代思路:不用插件,用命令行快速生成
如果你只需要偶尔导图,且已有代码片段,直接用 pygmentize + weasyprint 更轻量:
- 安装依赖:
pip install Pygments weasyprint - 高亮并生成 HTML:
pygmentize -f html -O full,style=vs,linenos=1 example.py > out.html - 转 PDF/PNG:
weasyprint out.html out.png(PNG 支持需额外装 Cairo) - 优点:不依赖 Sublime 环境,适合 CI 或批量处理;缺点:无实时选中范围,得先保存临时文件
真正卡住的往往不是“怎么点菜单”,而是浏览器路径写错、字体没加载、或 Sublime 主题名和插件预期不一致——这些细节比功能本身更影响落地。

















