codesnap 因依赖已移除的 webview.capturesnapshot() api，在 vscode 1.85+ 中必然失效，推荐改用 quickcodesnap、polacode 3.0+ 或 playwright 方案。
CodeSnap 插件已停止维护，VSCode 官方市场中最新版（v1.3.0）在 VSCode 1.85+ 上无法正常截图，生成图片常为空白或仅显示部分代码 —— 别折腾配置，直接换替代方案。
为什么 CodeSnap 在新版本 VSCode 中必然失败
CodeSnap 依赖已被弃用的 webview.captureSnapshot() API，该接口自 VSCode 1.84 起彻底移除。即使强行启用旧版插件、降级 VSCode 或修改 package.json 声明兼容性，也会触发安全拦截或返回空 Uint8Array，最终导出为纯白 PNG。
这不是权限、主题或字体问题，而是底层 API 断层 —— 所有「重装/刷新/改设置」类操作均无效。
真正可用的三个替代方案（按推荐顺序）
以下方案均实测通过 VSCode 1.85–1.90，支持暗色/亮色主题、自定义行号、多语言高亮、透明背景：
-
QuickCodeSnap（推荐）：开源、轻量、无网络请求，右键菜单一键截图，自动裁剪空白区域；安装后无需配置，
Ctrl+Shift+P输入QuickCodeSnap: Capture即可执行 -
Polacode 3.0+：需手动启用
polacode.includeLineNumbers和polacode.transparentBackground，注意关闭polacode.showEditorPreview（否则截图含编辑器边框） -
命令行 + playwright（高级用户）：用
playwright codegen录制打开 webview 的动作，再调用page.screenshot({ fullPage: true })；适合批量生成或 CI 集成，但需额外安装 Node.js 和 Playwright
截图前必须检查的三项设置
无论用哪个插件，以下设置直接影响输出质量：
- 确保当前文件已保存（未保存的临时标签页可能不触发语法高亮）
- 关闭所有折叠区域（
Ctrl+K Ctrl+0），否则折叠符号会截断代码逻辑 - 将缩放级别设为
100%（Ctrl+=/Ctrl+-调整），非 100% 缩放会导致字体模糊或错位
导出图片后容易被忽略的细节
很多人导出后发现文字发虚、颜色偏灰、行号错位——这通常不是插件问题，而是 VSCode 渲染层与系统 DPI 缩放不匹配导致的。Windows 用户若设置了「缩放与布局」> 125% 或 150%，必须在 VSCode 快捷方式属性 → 「兼容性」→ 勾选 替代高 DPI 缩放行为 并选 应用程序，否则截图永远带锯齿。
Mac 用户需确认系统「显示器」设置中未启用「默认为低分辨率」，且 VSCode 未以 Rosetta 模式运行。
