polacode截图乱码、截断、发灰、报错的四大原因及解决：①字体设为支持中文的等宽字体列表；②需手动选区或全选确保截取范围；③关闭透明背景并设置背景色；④macos需安装code命令至path。
Polacode 导出图片时代码乱码或字体不对
根本原因是插件默认用系统等宽字体，但中文或特殊符号没嵌入，Windows/macOS/Linux 默认字体链不同，导出图里常出现方块或字母歪斜。
实操建议：
- 在 VSCode 设置里搜
polacode.fontFamily，改成明确支持中文的等宽字体，比如"Fira Code", "Sarasa Mono SC", "JetBrains Mono"（注意加英文引号和逗号） - 别只写一个字体名，要写成字体列表形式，让 Polacode 有 fallback；单独写
Sarasa Mono SC在没装该字体的机器上会直接回退到系统默认，又变乱码 - 改完设置后必须重启 Polacode 预览窗口（关掉再按
Ctrl+Shift+P→Polacode: Take Screenshot），热重载不生效
截图区域选不中某几行或自动截断
Polacode 不是截编辑器视口，而是基于当前选中文本范围生成图片。没选中任何内容时，它会按“当前光标所在行 + 上下各 5 行”粗略估算，默认最多截 20 行，超出就砍掉。
实操建议：
- 想截固定范围：先用鼠标拖选代码（哪怕只选一个空格），再触发截图，
Polacode会严格按选区来 - 想截整个文件但又不想手动拉到底：按
Ctrl+A全选（确保在编辑器内，不是终端或搜索框），再截图 - 发现总少截一行？检查是否开启了
polacode.includeLineNumbers，开启后行号占位会导致实际代码行数被压缩，可临时关掉它再试
导出图片背景透明但分享到微信/钉钉后发灰
因为 Polacode 默认输出 PNG 且设了 polacode.transparentBackground 为 true，而微信、钉钉、飞书等 App 的图片查看器不渲染 alpha 通道，把透明当成了浅灰底。
实操建议：
- 分享前务必关掉透明背景：在设置里把
polacode.transparentBackground设为false - 顺手设好
polacode.backgroundColor，比如"#1e1e1e"（VSCode 暗色主题常用背景），避免白底反光看不清语法高亮 - 如果团队用统一主题，建议把
polacode.fontSize调到14或16，小字号在手机上根本看不清关键字颜色
Mac 上用 Polacode 截图报错 “command not found: polacode”
这不是插件问题，是 Polacode 依赖 VSCode 自带的 code CLI 命令，而 macOS 安装 VSCode 时没勾选「Shell Command: Install 'code' command in PATH」，导致插件底层调用失败。
实操建议：
- 打开 VSCode → 左下角齿轮图标 →
Install 'code' command in PATH（如果灰色不可点，先退出 VSCode 再重开） - 终端里执行
which code确认返回路径（如/usr/local/bin/code），再重启 VSCode - 仍报错？检查是否用了
zsh但PATH没刷新：在~/.zshrc末尾加export PATH="/usr/local/bin:$PATH"，然后source ~/.zshrc
code 命令根本没进环境变量。
