Polacode 截图需手动配置 theme、fontFamily、scale 等参数才能正常显示：设 polacode.theme 为 "mac" 启用 Mac 风格边框，polacode.scale 取整数（如 2）防模糊，fontFamily 用带 fallback 的等宽字体链（如 "Sarasa Mono SC", "Fira Code", "monospace"），并关闭连字；开启文件名、语言标签和非透明背景需分别设置对应选项；快捷键须满足 editorTextFocus 条件且在已保存文件中触发。
Polacode 不是“开箱即用”的一键截图工具，它默认不带边框、不显文件名、字体模糊、中文易乱码——所有你看到的“漂亮截图”，都必须手动配置 polacode.theme、polacode.fontFamily、polacode.scale 等关键项才能达成。
怎么让截图带 Mac 风格边框和顶部控制栏
Polacode 的 mac 主题不是视觉开关，而是独立渲染逻辑，必须显式启用且满足触发条件。
-
polacode.theme值必须设为"mac"（大小写敏感，填"Mac"或"MAC"无效） - 仅当使用
polacode.captureActiveEditor（如快捷键触发）时才显示红黄绿按钮；若用polacode.captureSelection，会自动隐藏顶部栏 - 确保当前打开的是已保存的文件（.py/.js/.ts 等），未保存的
Untitled-1标签页会静默失败 - 改完设置后，已打开的 Polacode 预览窗口必须关闭再重新触发，否则样式不更新
为什么截图总是糊、发虚、中文字体变方块
根本原因是 Polacode 渲染不继承编辑器字体与缩放，而是用自己的一套配置，默认值对高 DPI 屏和中文字体极不友好。
-
polacode.scale必须设为整数（推荐2），设1.5或2.2会导致拉伸模糊；Retina / 144Hz 屏不设就必糊 -
polacode.fontFamily要写成带 fallback 的等宽字体链，例如："Sarasa Mono SC", "Fira Code", "monospace"—— 单写一个字体名，缺字就出方块 - 必须关闭连字：
"editor.fontLigatures": false，否则截图里!=、=>等符号可能粘连或缺失 - 改完后需关掉已有预览窗口再重试，热重载不生效
截图没文件名、语言图标、背景透明发灰怎么办
Polacode 默认关闭所有标识项，且 transparentBackground 默认为 true，这在微信、钉钉、飞书里会渲染成浅灰色底，不是你想要的“通透”。
- 开启文件名：设
"polacode.showFileName": true；开启语言标识："polacode.languageLabel": true（仅对有正确 language ID 的文件生效，如javascript，不是plaintext） - 关闭透明背景：
"polacode.transparentBackground": false；同时指定背景色，例如："polacode.backgroundColor": "#1e1e1e" - 加阴影和圆角：
"polacode.dropShadow": true和"polacode.borderRadius": 8（单位 px，设 0 就是直角） - 注意：
polacode.padding默认 64，左右留白过大，可调至24或32让代码更紧凑
快捷键绑定后按了没反应？先查这三个硬性条件
Polacode 对触发上下文极其敏感，不是焦点在哪儿都能截，很多“没反应”其实是被拦截了。
- 快捷键命令必须带
"when": "editorTextFocus"条件，否则在终端、设置页、搜索框里误触会报错command 'polacode.captureActiveEditor' not found - 必须确保光标在编辑器文本区内（不能在侧边栏、大纲、Git 面板），且当前标签页不是空的或未保存的临时文件
- macOS 用户需确认已勾选「Shell Command: Install 'code' command in PATH」，否则底层调用失败；Windows 用户检查是否被组策略禁用了屏幕录制权限
- 如果仍无响应，打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），看 Console 是否有Failed to load resource或Permission denied
真正影响截图质量的从来不是插件本身，而是 polacode.scale、polacode.fontFamily 和 polacode.theme 这三个配置项的组合效果——它们之间存在隐式依赖：比如 mac 主题下 padding 过大会吃掉语言图标位置，scale=2 但字体链没 fallback 会导致中文字体直接降级为系统默认并乱码。调一项，往往得同步看另外两项是否还匹配。
