Polacode：静态代码截图工具，非录屏软件
先说一个核心概念：Polacode本身并不支持录制，它是一款纯粹的静态代码截图工具。市面上所谓的“代码录制”其实是个常见的误解——你真正需要的，往往是「截取一张带语法高亮、主题风格统一、便于分享的代码图片」。而Polacode，恰恰是解决这个需求的利器，前提是你对它的工作方式和配置要点有清晰的了解。
为什么装了Polacode却点不动「Capture」按钮？
这个问题太典型了。最常见的原因，是你的编辑器当前没有打开一个被正确识别的源码文件。Polacode只对拥有明确语言模式的活动编辑器窗口生效。
- 首先，确保你打开的是一个真实的源码文件，比如
index.js或main.py，并且观察编辑器右下角的状态栏，那里应该显示对应的语言标识（例如“Ja vaScript”）。 - 如果状态栏显示的是“Plain Text”，你需要点击它，然后手动选择正确的语言（比如“Python”）。否则，执行
polacode.capture命令时，它会静默失败，让你毫无头绪。 - 最后，不妨检查一下插件是否被意外禁用：打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入“Polacode: Capture”，看看能否正常触发。
截图出来的代码没高亮、字体糊、背景全黑？
这通常是主题和字体配置惹的祸。Polacode默认会继承VSCode当前的主题和字体设置，但它只读取其中一部分配置。它不会采用终端的字体，也不响应某些自定义的CSS注入，并且对部分第三方主题（尤其是一些暗色高对比度主题，比如Night Owl）兼容性不佳。
- 主题选择：优先使用官方推荐的主题，如
Default Dark+或Default Light+，这能最大程度避免因第三方主题导致的颜色丢失或异常。 - 字体指定：在
settings.json中显式地为Polacode指定字体家族。例如："polacode.fontFamily": "'Fira Code', 'Dank Mono', monospace"
（注意，字体名两边的单引号需要保留。） - 背景问题：如果截图背景异常全黑或全白，检查
"polacode.includeBackground"这个设置。将其设为false会导出透明背景的PNG图片，适合直接贴到其他背景上；设为true则会包含编辑器主题的背景色。 - 显示行号：默认情况下，Polacode不会显示行号。如果需要，启用
"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），都会直接影响最终图像的清晰度与可读性。因此，当你调出一套满意的配置后，建议将其导出为配置片段保存下来，以免重装环境后又要从头调试一遍。
