Polacode 截图无 Mac 风格是因未启用 mac 主题,需手动设置 polacode.theme 为 “mac”;截图白边大需调小 polacode.padding(如 24)和 polacode.width(如 720);颜色字体异常则需确保使用等宽字体、关闭连字、选用支持 token 颜色的主题,并设 polacode.scale 为整数。

Polacode 插件装完为啥截图还是白边、没 Mac 风格?
默认不启用 Mac 主题,必须手动开启 polacode.theme 配置项。插件自带三个主题:default(纯白)、mac(带圆角阴影和顶部控制栏)、vscode(模仿 VS Code 窗口)。很多人截图后发现还是方方正正的白框,就是卡在这一步。
实操建议:
- 打开 VS Code 设置(
Cmd + ,或Ctrl + ,),搜索polacode.theme - 把值从
default改成mac - 如果用 settings.json 手动改,加这一行:
"polacode.theme": "mac" - 改完不用重启,但已打开的 Polacode 预览窗口要关掉重开才生效
截图时代码区域太小、边距过大,怎么调?
polacode.padding 和 polacode.width 是最常被忽略的两个尺寸控制项。Mac 主题下 padding 默认是 64,左右留白巨大,尤其对短代码行很不友好;width 默认 800,窄屏或高 DPI 屏上容易裁切。
实操建议:
- 把
polacode.padding调小到32或24,视觉更紧凑 -
polacode.width建议设为720或680,适配常见分享场景(如 Twitter/X、Notion 嵌入) - 如果代码行数少,还觉得上下空太多,可以关掉
polacode.showLineNumbers,省出一行高度
复制代码后截图颜色错乱、字体发虚?
Polacode 截图依赖当前编辑器的主题配色和字体渲染。它不是“截图工具”,而是“复刻当前编辑器样式生成图片”。所以如果你用的是非等宽字体、或启用了字体连字(ligatures)、或主题用了自定义 token 颜色,Polacode 可能拿不到准确样式。
实操建议:
- 确保你正在用的 VS Code 主题支持
editor.tokenColorCustomizations(比如 One Dark Pro、GitHub Dark Default) - 关闭连字:在 settings.json 中设
"editor.fontLigatures": false,否则截图里字母可能粘连或缺失 - 字体必须是等宽且已安装到系统:推荐用
Fira Code、JetBrains Mono或系统自带的Menlo(macOS) - 如果截图文字模糊,检查
polacode.scale是否被误设为非整数(如1.5),建议固定为2(Retina 屏清晰)或1(普通屏)
为什么有些代码块截图后顶部控制栏消失?
Mac 主题的顶部控制栏(红黄绿三色按钮)只在「截取整个编辑器视图」或「截取活动代码块」时出现;如果用 polacode.captureSelection(快捷键 Cmd+Shift+P → Polacode: Capture Selection),它会按选中文本内容生成最小画布,自动隐藏控制栏——这是设计行为,不是 bug。
实操建议:
- 想要带控制栏的完整截图,用
Polacode: Capture Active Editor或Polacode: Capture All Editors - 想保留控制栏又只截一部分代码?先用鼠标拖选,再执行
Capture Active Editor,然后在预览界面手动拖动裁剪框,控制栏会保留 - 注意:控制栏颜色由
polacode.macTitleBarColor控制,默认是#252526(深灰),可改成#1e1e1e更接近原生 macOS
Mac 风格不是开个开关就完事的,padding、scale、字体、主题渲染这几处一环扣一环。调一次参数后记得关掉所有 Polacode 预览窗,再试一次,不然容易以为没生效。