Polacode插件需手动触发命令面板调用，仅支持已保存文件中的选中代码；无边框因默认theme为default，须显式设为mac或dracula；模糊需设scale为2，中文乱码应配置中文字体，截图缺行须先选中代码再截图。
Polacode 插件装上就用不了？不是你操作错，是它根本没在“等你点按钮”——它只响应已保存文件里的选中代码，且必须手动触发命令面板调用，不支持右键菜单或快捷键默认绑定。
Polacode 命令搜不到 / 点击无反应
这是最常卡住的第一步。插件启用后仍找不到 Polacode: Capture Current Editor，大概率是以下三个条件没同时满足：
- 当前编辑器标签页打开的是**已保存的代码文件**（如
index.js、main.py），不是未保存的 Untitled-1 或纯空白页 - 光标必须落在编辑器内容区，不能在终端、搜索框、设置页等非编辑区域
- macOS 或 Windows 已授予 VS Code 屏幕录制权限（macOS：系统设置 → 隐私与安全性 → 屏幕录制；Windows：设置 → 隐私 → 屏幕录制）
如果仍无效，按 Ctrl+Shift+P 输入 Developer: Toggle Developer Tools，切到 Console 标签页，再点截图命令，看是否有 Permission denied 或 Failed to load resource 报错。
截图没边框 / 还是白底方块图
Polacode 默认主题是 default，就是纯白无边框。要出 Mac 风格圆角阴影，必须显式指定主题，且值只能是它内置的字符串：
- 打开设置（
Ctrl+,），搜polacode.theme，下拉选mac（带顶部控制栏+圆角阴影）或dracula（紫边+柔光） - 别手输
Dark+、GitHub Dark或路径，这些都不被识别，会静默回退到default - 改完不用重启 VS Code，但已打开的 Polacode 预览窗口得关掉重开才生效
若还想要标题栏显示文件名和语言，额外加配置："polacode.languageLabel": true —— 但前提是当前文件 language ID 正确（比如 .py 文件不能被识别为 plaintext）。
文字模糊 / 中文乱码 / 截图发灰
这三类问题根源不同，但都和字体与背景配置强相关：
- 模糊：高 DPI 屏幕必设
"polacode.scale": 2，否则导出图是 1x 渲染后拉伸，字边缘锯齿明显 - 中文乱码：改
polacode.fontFamily为中文字体优先的列表，例如"'Sarasa Mono SC', 'Microsoft YaHei', monospace"（注意引号和逗号） - 发灰：微信/钉钉不渲染透明背景，务必关掉
"polacode.transparentBackground": false，并配一个深色背景如"polacode.backgroundColor": "#1e1e1e"
所有字体和背景类配置改完后，Polacode 预览窗口必须关闭重开，热重载不生效。
截出来的图缺行 / 有滚动条 / 行号错位
Polacode 默认只截当前选区；没选中时，它按“光标所在行 ±5 行”估算，最多 20 行，极易截断：
- 想截全文件：先按
Ctrl+A全选（确保在编辑器内），再触发截图 - 想截固定片段：鼠标拖选任意范围（哪怕只选一个空格），它就严格按这个范围生成
- 行号错位？检查
"polacode.includeLineNumbers"是否开启——开启后会强制加一列行号，挤占代码宽度，导致换行异常；临时关掉它能立刻改善
另外，"polacode.height": 800 可扩大垂直截取高度，但别超 2000，否则 Node.js 内存溢出报错。
真正容易被忽略的是：Polacode 不读取 VS Code 主题或编辑器缩放设置，所有样式（字号、边框、阴影）都靠自己那套配置项驱动，且多数修改只对新打开的预览窗口生效——关掉再重来，比反复刷新设置更可靠。
