CodeSnap最小可行配置需设"codesnap.showLineNumbers": true、"codesnap.scale": 2、"window.zoomLevel": 0，并确保语言模式正确和代码已选中，否则右键无响应或截图模糊。
CodeSnap 导出代码图片的最小可行配置
CodeSnap 是本地生成、零依赖的首选，不用开浏览器、不传代码到任何服务。装完插件后，默认设置会导出深色背景+无行号+小字体的图，直接发文档里常被吐槽“看不清”。关键就三件事：polacode.showLineNumbers 要开，polacode.padding 要调小，window.zoomLevel 必须为 0。
在 VS Code 设置中搜 settings.json，粘贴以下片段（覆盖或追加）：
{
"polacode.showLineNumbers": true,
"polacode.padding": 24,
"polacode.scale": 2,
"window.zoomLevel": 0
}
-
polacode.padding设为 24 是小代码块安全值；低于 12 可能切掉首尾行 -
polacode.scale控制输出分辨率，设为 2 后 PNG 更清晰，但文件体积略增 -
window.zoomLevel不是建议——是硬性要求。设为 1 或 -1 都会导致字体模糊，因为 Polacode 截的是渲染后的 UI 像素
Carbon 插件导出时卡在浏览器打不开怎么办
Carbon 插件（如 carbon-now-sh）本质是把代码发给 carbon.now.sh 网站渲染，所以失败几乎全是网络链路问题。不是插件坏了，而是请求没发出去或没回来。
- 检查 VS Code 是否被系统代理拦截：打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切换到 Console 标签页，触发 Carbon 导出，看有没有net::ERR_CONNECTION_REFUSED或CORS报错 - 如果看到
Failed to fetch，大概率是本地开了代理但没配通，或者公司防火墙屏蔽了 carbon.now.sh 域名 - 临时绕过办法：复制选中代码 → 手动打开 https://carbon.now.sh → 粘贴 → 调好主题/字体后点 Export，不依赖插件
- 不想用网页版？换
CodeSnap或Mermaid Preview（后者适合流程图，非代码）
Mermaid 流程图右键没有 Download as PNG 选项
这不是插件没装对，而是文件没被识别为 Mermaid 源。VS Code 的 Mermaid Preview 插件只响应两类路径：以 .mmd 结尾的文件，或 Markdown 文件中严格符合 ```mermaid ``` 语法的代码块（注意末尾三个反引号必须独占一行，且前后空行要足）。
- 检查当前文件后缀是不是
.md或.mmd；如果是.txt或无后缀，右键永远没导出菜单 - 检查代码块是否写成
```mermaid（无空格、无大小写混用），且结尾是```单独一行，不能跟文字挤在一起 - 预览区没加载出来？按
Ctrl+Shift+P输入Mermaid: Toggle Preview强制唤起 - 仍不显示菜单？重启 VS Code，插件有时在热重载后未绑定右键事件
导出的 PNG 字体模糊、边框锯齿严重
根本原因只有一个：你在导出前没放大预览视图。VS Code 的截图类插件（Polacode、CodeSnap、Mermaid Preview）都基于当前编辑器缩放比例渲染，而默认 window.zoomLevel 是 0，但很多人手动调高过（比如为了看清小屏字体），却忘了导出前切回去。
- 导出前务必确认状态栏右下角显示
100%；如果不是，按Ctrl+0重置缩放 - Mermaid Preview 导出模糊？先按
Ctrl+=放大 2~3 次，再右键Download as PNG，最后用系统画图裁白边 - CodeSnap 模糊？除了
window.zoomLevel: 0，还要关掉polacode.showWindowControls，否则窗口控件边缘会参与抗锯齿计算，导致代码区域轻微虚化 - 别信“导出 SVG 再转 PNG”这种方案——SVG 在 Mermaid Preview 里导出的是矢量路径，但含大量文本
真正麻烦的不是怎么导出，而是导出后发现同事打不开：PNG 被微信压缩、SVG 在 PPT 里乱码、PDF 里字体缺失。这些都不是 VS Code 的问题，是下游使用场景倒逼你提前选格式——需要钉钉发，就用 CodeSnap 直出 PNG；要嵌进 Word 报告，就 Mermaid Preview 导 SVG，再用 Edge 浏览器另存为高倍 PNG。
