Polacode不支持真正一键生成,需三步配置:绑定Ctrl+Alt+S快捷键触发截图、设polacode.theme为"mac"启用Mac风格边框与文件名标识、调polacode.scale=2和fontFamily等宽字体链解决模糊与乱码。

Polacode不支持“一键生成”——它只响应手动触发,且默认样式简陋、无边框、无文件名、字体模糊。所谓“快速生成漂亮截图”,必须靠快捷键绑定 + 主题配置 + 字体与缩放调优三步到位。
怎么给 Polacode 绑定 Ctrl+Alt+S 快捷键直接截图
插件安装后不会自动分配快捷键,必须手动写入 keybindings.json:
- 按
Ctrl+Shift+P→ 输入Preferences: Open Keyboard Shortcuts (JSON) - 在数组里加一条规则:
{ "key": "ctrl+alt+s", "command": "polacode.captureActiveEditor", "when": "editorTextFocus" } -
when条件不能删,否则在终端或设置页误触会报错command 'polacode.captureActiveEditor' not found - Mac 用户把
ctrl换成cmd;改完不用重启 VS Code,但需确保当前焦点在编辑器内(不能在侧边栏或搜索框)
为什么截图总是发虚、中文乱码、行号错位
根本原因:Polacode 渲染不继承编辑器字体/缩放,而是用自己独立配置,且默认值对高 DPI 屏和中文字体极不友好。
-
polacode.scale必须设为2(不是1.5或3),否则 144Hz/Retina 屏导出图是拉伸模糊 -
polacode.fontFamily要写成带 fallback 的等宽字体链,例如:"Sarasa Mono SC", "Fira Code", "monospace"—— 单写一个字体名,缺字就变方块 -
polacode.includeLineNumbers开启后会挤占宽度,导致长行换行异常;分享图若只关注逻辑,建议关掉 - 改完这两项后,必须关闭已打开的 Polacode 预览窗口,再重新触发截图才生效(热重载无效)
怎么让截图带 Mac 风格边框、文件名、语言标识
Polacode 默认主题是 default(纯白无边框),要出风格必须显式指定内置主题,且配齐配套参数:
- 设
polacode.theme为"mac"(不是Mac或MAC,大小写敏感)—— 这才启用顶部红黄绿按钮 + 圆角阴影 - 开
polacode.languageLabel和polacode.showFileName,才能显示右上角语言图标和顶部路径栏 - 若顶部留白太大,调小
polacode.padding(推荐24)和polacode.width(推荐720) - 别碰
polacode.dropShadow或polacode.borderRadius:mac 主题下这些由主题自身控制,手动设反而失效
截图导出后微信/钉钉里发灰、没边框、背景全黑
这是透明背景 PNG 在 IM 客户端的典型渲染问题,不是截图失败。
-
polacode.transparentBackground默认为true,必须手动设为false - 顺手配
polacode.backgroundColor,比如暗色主题配"#1e1e1e",亮色配"#ffffff" - 如果截图里还带滚动条或光标,说明 VS Code 编辑器本身没关:
editor.scrollbar.vertical设为"hidden",editor.cursorBlinking设为false - 注意:Polacode 不截选区,只截整个活动编辑器内容;想精准控制范围,得先
Ctrl+A全选,或手动拖选再触发polacode.captureSelection
真正卡住人的点不在“会不会用”,而在“改了配置却不生效”——因为 Polacode 对配置变更极其迟钝:改 fontFamily 后不关预览窗,还是糊字;设了 theme 却没关旧窗口,依然白底;甚至 macOS 上没装 code CLI 命令,都会静默失败。每调一项,都得亲手关一次截图预览再重试。











