Polacode插件没反应需检查theme冲突、scaleFactor缩放、selection模式及fontFamily设置：显式指定polacode.theme为dark/light/dracula；scaleFactor设为2或3提升清晰度；用Copy Selection命令而非默认行截图；fontFamily设为空字符串""以继承编辑器字体。

Polacode 插件安装后没反应？检查 VSCode 的 workbench.colorTheme 和 polacode.theme 冲突

Polacode 生成图片时会读取当前编辑器主题作为背景色，但若你用了非标准主题（比如自定义 JSON 主题、或某些轻量主题如 Nord、Rose Pine），它可能无法正确提取颜色，导致导出图一片灰白或文字不可见。

解决方法是显式指定 Polacode 自带的主题，而非依赖编辑器主题：

• 打开 VSCode 设置（Ctrl+, 或 Cmd+,），搜索 polacode.theme
• 将其设为 dark、light 或 dracula 等内置值（不要留空或填自定义主题名）
• 同时确认 workbench.colorTheme 是一个 Polacode 能识别的主流主题（如 Default Dark+），否则截图区域可能裁剪异常

用 polacode.copyToClipboard 命令导出图片模糊？调整 polacode.scaleFactor 是关键

默认导出分辨率偏低，尤其在高 DPI 屏幕（如 MacBook Retina、Windows 缩放 125%+）上，图片边缘发虚、字体锯齿明显。这不是插件 bug，而是 Electron 渲染层对缩放因子的处理逻辑问题。

必须手动提高缩放倍数才能输出清晰图：

• 在设置中搜索 polacode.scaleFactor
• 设为 2（推荐起点），若仍不够锐利可试 3；超过 4 易触发内存警告
• 注意：该值不影响预览窗大小，只影响最终图片像素密度
• 导出前务必关闭所有折叠代码块（Ctrl+Shift+[），否则缩放后行号错位

选中多行代码后按 Ctrl+Shift+P → Polacode: Copy to Clipboard，却只截了单行？

Polacode 默认行为是「截取当前光标所在行」，不是「截取选中区域」——这是最常被误解的点。它不读取 selection，而是读取 editor 的 active line range，除非你主动启用 selection 模式。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

要真正按选区截图：

• 先选中目标代码（支持跨文件？不支持，仅限当前打开的 editor）
• 运行命令 Polacode: Copy Selection to Clipboard（注意命令名含 Selection）
• 或者快捷键：默认无绑定，需手动在 keybindings.json 中添加：

  { "key": "ctrl+alt+c", "command": "polacode.copySelectionToClipboard" }

• 若选区含空行过多，导出图会出现大片留白；建议提前删空行或用 editor.trimAutoWhitespace 关闭自动删空格

导出图片文字有乱码（尤其是中文、emoji 或箭头符号 → ← ⇒）？别碰 polacode.fontFamily 默认值

Polacode 底层用 Puppeteer 截图，字体回退链极短。一旦你手动改了 polacode.fontFamily（比如设成 "Fira Code"），而系统没装对应字体，就会 fallback 到系统默认等宽字体，中文往往显示为方框，emoji 直接消失。

稳妥做法是让 Polacode 自动继承编辑器字体：

• 把 polacode.fontFamily 设为空字符串 ""（不是 null，不是 "default"）
• 确保你的 VSCode 编辑器已正确配置中文字体，例如在 settings.json 加：

  "editor.fontFamily": "'Fira Code', 'Microsoft YaHei', Consolas, 'Courier New', monospace"

• 重启 VSCode —— Polacode 启动时只读一次字体配置，改完不重启无效

导出前最后看一眼预览窗口里的文字是否正常渲染，别等贴到群里才发现全是方块。