CodeSnap替代已停更的Polacode，需启用插件、正确选中代码、配置fontFamily/fontSize/scale解决中文乱码与模糊，设置transparentBackground=false、backgroundColor、borderRadius和dropShadow优化导出效果，并通过选区或Ctrl+A确保截图完整。
直接装 CodeSnap，别碰已停更的 Polacode——它在 2026 年已无维护，命令失效、中文乱码、macOS 路径报错等问题集中爆发，而 CodeSnap 保持更新，原生支持主题继承、剪贴板直出、终端样式等关键能力。
CodeSnap 安装后右键没反应？检查启用状态和触发范围
插件安装完不等于立刻可用。常见现象是右键菜单里找不到 CodeSnap 选项，或命令面板搜不到相关命令。
- 确认插件已“启用”：打开扩展页（
Ctrl+Shift+X），搜codesnap，看右侧是否显示“禁用”按钮；若显示“启用”，点一下 - 右键只在编辑器内容区生效，不在侧边栏、终端、搜索框等区域出现
- 必须先选中代码（哪怕只选一个空格），右键才弹出
CodeSnap子菜单；纯光标定位不触发 - 若仍无效，重启 VS Code —— 部分旧工作区缓存会阻止新插件加载命令
截图中文乱码或字体发虚？重点调三个配置项
不是主题问题，也不是系统缺字体，而是插件未正确嵌入中文字体或渲染缩放失配。
-
codesnap.fontFamily必须设为带中文字体 fallback 的列表，例如："Sarasa Mono SC", "Fira Code", "Consolas"（注意英文引号 + 逗号分隔） -
codesnap.fontSize建议设为14或16，VS Code 编辑器字号（editor.fontSize）不影响截图，这个才是真字号 -
codesnap.scale在高 DPI 屏（如 MacBook Retina、Windows 缩放 125%+）下必须设为2，否则导出图是 1x 渲染再拉伸，文字糊成一片
截图没边框、无阴影、背景透明发灰？别依赖默认值
CodeSnap 默认不加边框、不加阴影、背景透明 —— 这不是 bug，是精简设计。分享到微信、钉钉、飞书时，透明背景会被渲染成浅灰色，必须手动关掉。
- 关闭透明背景：
codesnap.transparentBackground设为false - 指定背景色：
codesnap.backgroundColor推荐填"#1e1e1e"（匹配 Dark+ 主题）或"#ffffff"（适配 Light+） - 加圆角和阴影：
codesnap.borderRadius设为8，codesnap.dropShadow设为true - 若想带文件名标题栏，用
CodeSnap: Take Snapshot with Options命令，输入showFilename=true
截图导出后行号错位、长行换行、少截一行？选区和宽度要对齐
CodeSnap 截图逻辑严格基于“当前选区”，不是视口滚动位置。默认行为容易误判范围。
- 不想靠猜：先用鼠标拖选完整代码块（包括空行），再右键 →
CodeSnap→Take Snapshot of Selection - 整文件截图：按
Ctrl+A（确保焦点在编辑器内），再触发截图命令 - 长行被截断：调大
codesnap.width到800或900，避免自动折行；超过1200会导致图片过宽，不适配多数平台 - 行号挤占空间导致代码少一行：关掉
codesnap.showLineNumbers，或在with Options中显式传showLineNumbers=false
真正卡住人的不是功能不会用，而是默认配置和真实分享场景之间存在三处断层：字体 fallback 写法、scale 值必须手动设、透明背景在社交 App 里必然变灰。这三点不调，截图永远“差点意思”。
