Polacode截图乱码、截断、发灰、报错的四大原因及解决:①字体设为支持中文的等宽字体列表;②需手动选区或全选确保截取范围;③关闭透明背景并设置背景色;④macOS需安装code命令至PATH。
Polacode 导出图片时代码乱码或字体不对
根本原因是插件默认用系统等宽字体,但中文或特殊符号没嵌入,Windows/macOS/Linux 默认字体链不同,导出图里常出现方块或字母歪斜。
实操建议:
在 VSCode 设置里搜
,改成明确支持中文的等宽字体,比如
(注意加英文引号和逗号)
别只写一个字体名,要写成字体列表形式,让 Polacode 有 fallback;单独写
在没装该字体的机器上会直接回退到系统默认,又变乱码
改完设置后必须重启 Polacode 预览窗口(关掉再按
→
),热重载不生效
截图区域选不中某几行或自动截断
Polacode 不是截编辑器视口,而是基于当前选中文本范围生成图片。没选中任何内容时,它会按“当前光标所在行 + 上下各 5 行”粗略估算,默认最多截 20 行,超出就砍掉。
实操建议:
想截固定范围:先用鼠标拖选代码(哪怕只选一个空格),再触发截图,
会严格按选区来
想截整个文件但又不想手动拉到底:按
全选(确保在编辑器内,不是终端或搜索框),再截图
发现总少截一行?检查是否开启了
,开启后行号占位会导致实际代码行数被压缩,可临时关掉它再试
导出图片背景透明但分享到微信/钉钉后发灰
因为 Polacode 默认输出 PNG 且设了
为
,而微信、钉钉、飞书等 App 的图片查看器不渲染 alpha 通道,把透明当成了浅灰底。
VSCode 1.118
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力,其中最引人注目的是新增 Copilot CLI 远程控制功能,允许开发者通过手机或网页远程监控和接管 AI 会话 。同时,为了提高 AI 的运行性价比,新版本优化了令牌缓存策略以降低成本 。此外,1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
下载
实操建议:
分享前务必关掉透明背景:在设置里把
设为
顺手设好
,比如
(VSCode 暗色主题常用背景),避免白底反光看不清语法高亮
如果团队用统一主题,建议把
调到
或
,小字号在手机上根本看不清关键字颜色
Mac 上用 Polacode 截图报错 “command not found: polacode”
这不是插件问题,是 Polacode 依赖 VSCode 自带的
CLI 命令,而 macOS 安装 VSCode 时没勾选「Shell Command: Install 'code' command in PATH」,导致插件底层调用失败。
实操建议:
打开 VSCode → 左下角齿轮图标 →
(如果灰色不可点,先退出 VSCode 再重开)
终端里执行
确认返回路径(如
),再重启 VSCode
仍报错?检查是否用了
但
没刷新:在
末尾加
,然后
字体、选区、背景、CLI 这四块不调对,截图看着像样,发出去就是糊的、缺的、灰的、报错的。尤其 Mac 用户容易卡在最后一步——以为装了插件就完事,其实
命令根本没进环境变量。
polacode.fontFamily"Fira Code", "Sarasa Mono SC", "JetBrains Mono"Sarasa Mono SCCtrl+Shift+PPolacode: Take ScreenshotPolacodeCtrl+Apolacode.includeLineNumberspolacode.transparentBackgroundtruepolacode.transparentBackgroundfalsepolacode.backgroundColor"#1e1e1e"polacode.fontSize1416codeInstall 'code' command in PATHwhich code/usr/local/bin/codezshPATH~/.zshrcexport PATH="/usr/local/bin:$PATH"source ~/.zshrccode