CodeSnap右键没反应需先启用插件、在编辑器内容区选中代码（哪怕一个空格）才触发；中文乱码须配置codesnap.fontFamily含中文字体、fontSize设14/16、scale设2适配高DPI；透明背景、无边框等问题需手动设置transparentBackground为false、backgroundColor、borderRadius和dropShadow。
别再用 Polacode 了——它已停更，2026 年起命令失效、中文乱码、macOS 路径报错集中爆发，且不修复。直接换 CodeSnap。
CodeSnap 安装后右键没反应？检查启用状态和触发范围
插件安装完不等于立刻可用。常见现象是右键菜单里找不到 CodeSnap 选项，或命令面板搜不到 CodeSnap: Take Snapshot。
- 确认插件已“启用”：打开扩展页（
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 截图逻辑严格基于“当前选区”，不是视口滚动位置。默认行为容易误判范围。
- 必须手动选中目标代码块（包括首尾空行，如有需要）；仅靠滚动到某处再截图，大概率漏行
- 长代码行若被自动折行，截图会按折行后布局渲染；如需保持单行长格式，提前在 VS Code 中关闭
editor.wordWrap - 若启用了
codesnap.showLineNumbers，注意行号列宽计入整体宽度；必要时配合codesnap.width手动设宽（如800） - 截图前按
Ctrl+K Ctrl+Z进入 Zen Mode（专注模式），避免侧边栏干扰布局计算
最易被忽略的一点：所有配置项都必须写在 VS Code 的全局或工作区 settings.json 里，不能只在 UI 设置界面点选——部分选项（如 fontFamily、scale）UI 界面根本不提供输入框，改了也无效。
