Polacode是静态代码截图工具，非录屏软件；需打开有明确语言模式的已保存源码文件（如.js/.py），确保右下角显示对应语言标识，否则Capture命令静默失败。
Polacode 本身不支持录制，它只是静态截图工具；所谓“代码录制”是常见误解——你真正需要的，是「截取带语法高亮、主题一致、可分享的代码图」，而 Polacode 能做好这件事，前提是 VSCode 配置正确、插件行为理解到位。
为什么装了 Polacode 却点不动「Capture」按钮？
最常见原因是当前编辑器没有打开任何文件，或打开的是不被识别的类型（比如纯文本 .txt 或未关联语言的空文件）。Polacode 只对有明确语言模式（language mode）的活动编辑器生效。
- 确保已打开一个真实源码文件，例如
index.js、main.py，且右下角状态栏显示对应语言（如JavaScript） - 若显示
Plain Text，点击它 → 选择正确语言（如Python），否则polacode.capture命令会静默失败 - 检查是否禁用了 Polacode：在命令面板（
Ctrl+Shift+P/Cmd+Shift+P）输入Polacode: Capture，看是否可触发
截图出来的代码没高亮、字体糊、背景全黑？
Polacode 默认复用 VSCode 当前主题和字体设置，但只读取部分配置。它不继承终端字体、不响应自定义 CSS 注入，且对某些主题（尤其是暗色高对比主题如 Night Owl）兼容性差。
- 优先使用官方推荐主题：
Default Dark+或Default Light+，避免第三方主题导致颜色丢失 - 在
settings.json中显式指定字体，例如："polacode.fontFamily": "'Fira Code', 'Dank Mono', monospace"
（注意单引号需保留） - 若背景异常黑/白，检查
"polacode.includeBackground"是否为true；设为false会导出透明背景 PNG（适合贴图） - 行号默认不显示，如需添加，启用
"polacode.showLineNumbers": true
如何截取多文件、带标题、自动保存到指定路径？
Polacode 原生只支持当前活动编辑器单文件截图，但可通过组合配置逼近「批量+结构化输出」效果。
- 多文件截图：手动切换标签页 → 每次执行
Polacode: Capture（无快捷键自动连拍） - 加标题：在
settings.json中配置"polacode.title": "api.ts — User endpoints"，它会固定显示在图顶部（不随文件变化） - 指定保存路径：设置
"polacode.outputPath": "./screenshots"（路径相对于工作区根目录；文件夹需预先存在） - 想带文件名水印？原生不支持，但可配合
polacode.fileNameTemplate控制命名，例如"{fileName}-{date}"→ 输出App.vue-20240521.png
Polacode 的边界很清晰：它不是录屏工具，也不生成 GIF 或视频；它的价值在于「一键导出符合开发者审美的代码快照」。最容易被忽略的一点是：截图结果高度依赖 VSCode 编辑器当前渲染状态——缩放级别（zoomLevel）、换行开关（editor.wordWrap）、甚至是否启用了 editor.renderWhitespace，都会直接影响最终图像的可读性。调好一次后建议导出配置片段，避免重装后反复调试。
