polacode 是 vs code 插件，非命令行工具，需通过命令面板调用；截图前必须先选中代码，且需正确配置 polacode.theme 等参数才能显示边框和优化清晰度。

Polacode 安装后没反应，polacode 命令不识别

Polacode 是 VS Code 插件，不是命令行工具，不能在终端里直接运行 polacode。它只在编辑器内通过命令面板触发。

常见错误是误以为要手动安装 CLI 或配置 PATH —— 实际上完全不需要。只要插件启用，就能用快捷键或命令面板调用。

• 确认插件已从 VS Code 扩展市场安装并启用（搜索 “Polacode”，作者是 pengx17）
• 重启 VS Code（部分旧版本需重启才加载新插件）
• 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Polacode: Capture Current Editor 尝试运行
• 如果命令搜不到，检查插件是否被禁用，或查看 VS Code 右下角状态栏有没有显示“Polacode is ready”提示

截图没有边框 / 主题颜色不对，polacode.theme 配置无效

Polacode 的边框、字体、背景等样式由内置主题控制，不是靠系统主题或 VS Code 主题自动继承。必须显式设置 polacode.theme 配置项，且值必须是它支持的字符串。

容易踩的坑是填了自定义 CSS 路径、VS Code 主题名（比如 Dark+ ），或拼写错误（如 dracula 写成 Dracula）—— 这些都会导致回退到默认无边框的 default 主题。

VSCode

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

下载

• 打开 VS Code 设置（Ctrl+,），搜索 polacode.theme
• 下拉选择预设主题：推荐 dracula（紫边+圆角）、github-dark（深灰边+浅灰代码区）、atom（蓝边+阴影）
• 不要手动输入路径或主题 ID；所有合法值都在插件文档的 theme 字段说明里列明
• 改完后无需重启，但当前截图窗口需关闭重开才生效

截出来的图文字模糊、字号太小，或代码被截断

Polacode 默认使用编辑器当前缩放级别和字体大小渲染，但它会强制把代码区域缩放到固定宽度（约 600px），导致高 DPI 屏幕或大字号下文字压缩失真，或长行被截断。

这不是 bug，而是设计取舍：它优先保证分享图尺寸统一、适配社交媒体宽高比。想改善可调三项关键配置：

• polacode.width：增大到 800 或 900，缓解横向截断（但别超 1200，否则生成图过宽）
• polacode.fontSize：设为 14 或 16（单位是 px，不是 VS Code 的 editor.fontSize）
• polacode.scale：设为 2（对高 DPI 屏幕必要，否则导出图是 1x 渲染再放大，必然模糊）
• 注意：scale 会影响文件体积，2 已足够清晰，3 以上没必要

导出 PNG 后发现有滚动条、行号、光标残留

Polacode 截的是「当前编辑器可见区域」，不是选中代码块。如果你没手动选中，它就照搬你眼睛看到的那一屏，包括行号、折叠图标、甚至未保存的光标闪烁。

这不是配置问题，是使用逻辑没对齐：它本质是个“美化截图工具”，不是“代码片段导出器”。想精准控制内容，必须先选中。

• 务必先用鼠标或键盘（Shift+↑/↓）选中你要分享的代码段
• 再执行 Polacode: Capture Selection（不是 Capture Current Editor）
• 选中后截图会自动隐藏行号、光标，并以选中范围为基准裁切，边框也更贴合代码边界
• 如果选中后仍有滚动条，说明选中范围跨了太多行 —— Polacode 不支持虚拟滚动，建议分段截图

实际用下来，最常卡住的点就两个：一是误当 CLI 工具折腾环境变量，二是没意识到“必须先选中才能精准截图”。边框好不好看，反而取决于你有没有关掉行号（editor.lineNumbers 设为 off）再截图——这步很多人忘了做。