compton配置中常见的错误及解决

Compton（现已发展为 Picom）作为轻量级窗口合成器，在 Linux 桌面环境中承担着透明、阴影、抗锯齿等视觉效果的重任。配置过程说简单也简单，说头疼也确实有不少隐藏的坑。下面就把最常见的几个错误和对应解法梳理一下，希望能帮你少走弯路。

1. 配置文件路径或语法错误

Compton 的配置文件默认放在 ~/.config/compton.conf（用户级）或 /etc/xdg/compton.conf（系统级）。路径不对，配置自然读不到；语法写错了（比如拼写、漏括号、值类型不对），也会直接失效。解决办法其实很直接：

• 先确认文件是否存在，用 ls ~/.config/compton.conf 或 ls /etc/xdg/compton.conf 看一眼；
• 测试语法：运行 compton --config ~/.config/compton.conf，如果有错误会直接报出来；
• 拿不准的选项，翻官方文档（GitHub 上的 Picom 仓库）核对最新写法，比如新版已用 shadow 替代了旧版 no-dock-shadow。

2. 弃用选项未更新

老版本的 Comptom 有不少选项后来被移除了，比如 no-dock-shadow、menu-opacity、glx-swap-method、clear-shadow。继续用它们只会弹出警告或直接让配置失效。怎么处理？

• 果断移除或替换：比如 no-dock-shadow true 改成 shadow dock true；menu-opacity 0.9 直接删掉，改用 shadow-exclude 来排除菜单；
• 更省事的办法：从 Picom GitHub 仓库下载一份默认配置（比如 picom.conf），覆盖旧文件，再逐步加上你需要的自定义项。

3. 后端设置不当

Compton 支持 xrender（软件渲染，兼容性好但性能一般）和 glx（利用 OpenGL 加速，性能高但挑显卡驱动）。选错了后端，窗口要么闪烁卡顿，要么直接起不来。调整思路如下：

• 先试 xrender——兼容性最好，几乎不会出问题；如果性能满意就用它；
• 想用 glx 时，务必检查显卡驱动是否装好（NVIDIA 需要 nvidia-driver，AMD 用 mesa）；
• 可以用 glxgears 测一下 GL 性能，帧率太低就老实切回 xrender。

4. 垂直同步（VSync）设置问题

vsync 负责让屏幕刷新和窗口更新同步，防止画面撕裂。但设置不对反而会拖累性能——比如显卡不支持却强行开启，帧率可能直接腰斩；关掉又容易撕裂。怎么选？

• 独立显卡（NVIDIA/AMD）通常可以开 vsync true；集成显卡或低功耗设备建议关掉或改为 false；
• 还可以微调同步类型：在配置里加上 vsync-type "opengl" 或 vsync-type "drm"，部分显卡能有更好效果。

5. 透明度/阴影效果无效

透明度或阴影没生效，多半是规则写错了，或者排除项太多把需要的窗口也干掉了。检查点很明确：

• 透明度规则要严格按照格式来，比如 opacity-rule = ["85:class_g = 'Alacritty'", "100:fullscreen"]——其中 class_g 可以用 xprop 命令查到窗口的类名；
• 阴影排除项别太宽泛：shadow-exclude = ["name = 'Notification'", "class_g = 'Conky'"] 就能把通知和 Conky 排除掉；
• 不确定时先设一个全局效果（比如 shadow true + opacity 0.8），确认基础功能正常，再一条条加精细化规则。

6. 性能瓶颈（CPU/GPU占用过高）

特效开多了（尤其是模糊、阴影、透明度全上），CPU/GPU 占用自然飙升，系统会明显变卡。优化方向不外乎以下几种：

• 关掉不必要的特效：bg-blur false、shadow false、opacity false 是最直接的降频手段；
• 如果用的是 xrender 后端，可以换成 glx 利用 GPU 分担计算；
• 实在不行还能限制资源：用 cpulimit -l 50 -p $(pgrep compton) 限 CPU 使用率，或者在 systemd 服务里加 CPUQuota=50%。

7. 与其他组件冲突

Compton 和 GNOME/KDE 自带的合成器或者第三方特效工具撞车，屏幕闪烁、卡顿、窗口显示异常都是常有的事。对策很清晰：

• 禁用系统内置合成器：GNOME 里在“设置→区域与语言→输入源”关掉“窗口特效”；KDE 里在“系统设置→显示与监视器→合成器”禁用；
• 如果不想全局禁用，就用 shadow-exclude 或 opacity-exclude 排除冲突进程（比如 gnome-shell、plasmashell）；
• 临时解决：killall gnome-shell 或 killall plasmashell 停掉冲突组件，再启动 Compton 测试。