polacode需手动配置快捷键、dpi缩放、字体及模板才能实现清晰带标识的代码截图：绑定ctrl+alt+s触发截取，设scale为2、fontfamily为fira code等连字等宽字体，启用default-with-filename模板并自定义css边框，关闭ligatures和smoothing，保存为utf-8无bom。
Polacode 本身不支持“一键生成截图”——它只在你手动触发后截取当前编辑器选区或活动文件，所谓“一键”必须靠快捷键绑定或命令调用实现，且默认样式简陋，需手动配置主题、字体、边框等才适合分享。
怎么给 Polacode 绑定全局快捷键快速截图
Polacode 没有开箱即用的快捷键，必须进 VSCode 快捷键设置里手动绑定：Ctrl+Shift+P → 输入 Preferences: Open Keyboard Shortcuts (JSON) → 在 JSON 中添加一条规则：
{
"key": "ctrl+alt+s",
"command": "polacode.captureActiveEditor",
"when": "editorTextFocus"
}
这样按 Ctrl+Alt+S 就能立刻截取当前打开的代码文件（不含终端/调试面板）。注意：when 条件必须保留，否则在非编辑器区域误触会报错；Mac 用户把 ctrl 换成 cmd。
为什么截图总是糊/字体发虚——关键在 DPI 和字体配置
Polacode 截图模糊，90% 是因为没指定高 DPI 渲染和等宽字体。它默认用系统字体，Windows 上常是 Consolas（渲染差），macOS 上是 Menlo（还行），但都不保证清晰。必须在 VSCode 设置中加这两项：
-
"polacode.fontFamily": "'Fira Code', 'JetBrains Mono', monospace"—— 推荐优先写开源且带连字的字体，避免用Microsoft YaHei这类非等宽字体 -
"polacode.scale": 2—— 强制 2x 渲染，尤其对 144Hz 或高分屏用户必要；设为1.5会锯齿，3文件过大
改完重启 VSCode 才生效，别只重载窗口。
怎么让截图带文件名、语言标识和暗色边框——靠 template 配置
Polacode 的 template 选项控制截图结构，不配就只有纯代码块。想显示顶部标签栏（含语言图标 + 文件路径），得在设置里填完整模板字符串：
"polacode.template": "default-with-filename"
但这个内置模板不带边框。真要加圆角+阴影+深灰边框，只能自定义：polacode.customTemplate 设为本地 HTML 路径（如 ./polacode-template.html），并在该文件里用 CSS 写 border: 2px solid #1e1e1e; 和 border-radius: 8px;。注意：路径必须是工作区根目录下的相对路径，不能用 ~ 或绝对路径。
截图导出后中文乱码或符号错位——编码和 ligature 要关掉
连字（ligature）开启时，==>、!= 等符号在截图里可能粘连或偏移；某些中文字体未嵌入截图，导致方块或空格。解决方式很直接：
- 关闭连字：
"editor.fontLigatures": false（VSCode 全局设置，不是 Polacode 专属） - 禁用抗锯齿（仅 Windows）：
"polacode.disableSmoothing": true，否则微软雅黑字体边缘发虚 - 确保文件保存为 UTF-8 无 BOM —— 如果截图里中文变成
，大概率是源文件编码错了
这些设置改完，务必关掉所有 VSCode 窗口再重开，Polacode 的渲染进程不会热更新配置。
真正卡住人的地方不在怎么装插件，而在 DPI 缩放、字体回退链、模板路径解析这三者交织——任何一个环节路径写错、缩放没对齐、字体 fallback 到宋体，截图就会立刻露馅。分享前最好用 polacode.captureSelection 试截一段带中文和箭头符号的代码，一眼就能看出问题。
