codesnap 是最稳、最省心的代码截图方案，直接复用 vscode 主题与字体，支持一键截选中代码并自动存入剪贴板或目录，但需注意字体 fallback 顺序、scale 值和透明背景三处关键配置。
CodeSnap 是目前最稳、最省心的方案，不用开浏览器、不依赖外部服务、截图即所见。Polacode 已停更，Carbon 需跳转网页且导出流程长，都不适合“一键生成”这个需求。
为什么 CodeSnap 的 Take Snapshot of Selection 是首选
它直接复用 VSCode 当前主题、字体、缩放和语法高亮，不额外渲染、不二次采样，中文不乱码、连字不断裂、行号对齐精准。关键在于：选中代码 → 命令面板执行 CodeSnap: Take Snapshot of Selection → 图片自动进剪贴板或保存到 .codesnap/ 目录。
- 必须先手动选中（哪怕只选一个空格），否则会退化为截全文件，容易漏掉上下文或截入无关行
- 若截图后行号偏移或长行换行异常，大概率是
codesnap.containerPadding过小或codesnap.fontFamily缺少中文字体 fallback - 命令默认不带标题栏；如需显示
filename.py • Python，得改用CodeSnap: Take Snapshot with Options并输入showFilename=true
codesnap.fontFamily 配置错就全乱码
VSCode 编辑器里看着正常，截图却出方块？不是系统没装中文字体，而是 CodeSnap 只读 codesnap.fontFamily 且只取第一个能覆盖全部 Unicode 范围的字体。顺序错了，fallback 就失效。
- Mac 推荐：
"Sarasa Mono SC", "SF Mono", "PingFang SC", "monospace" - Windows 推荐：
"Sarasa Mono SC", "Microsoft YaHei", "Consolas", "monospace" - Linux 推荐：
"Sarasa Mono SC", "Noto Sans CJK SC", "DejaVu Sans Mono", "monospace" - 别写成
"Fira Code, Microsoft YaHei"—— 缺少引号和逗号分隔，VSCode 会直接忽略整条配置
截图发灰、边缘糊、没阴影？不是插件问题，是默认关了
CodeSnap 默认输出透明背景、无边框、无阴影——这是设计选择，不是 bug。但微信、钉钉、飞书等 App 不渲染 alpha 通道，透明=浅灰底；1x 渲染在高 DPI 屏上=模糊；无装饰=不像专业分享图。
- 关透明：
codesnap.transparentBackground设为false - 设背景：
codesnap.backgroundColor推荐"#1e1e1e"（暗色）或"#ffffff"（亮色） - 加圆角+阴影：
codesnap.borderRadius设8，codesnap.dropShadow设true - 高 DPI 屏必配：
codesnap.scale设为2，否则文字糊、图标虚
真正卡住人的从来不是“怎么点”，而是字体 fallback 顺序、scale 值和透明背景这三处配置——它们不出错时一切丝滑，一错就全盘失效，且错误现象（发灰/乱码/模糊）和根源完全不对应，排查起来特别绕。
