Ubuntu 下 Compton 配置的常见误区与规避
一 配置与路径误区
- 将配置文件放在错误位置或写成绝对路径如 /.config/compton.conf（缺少用户主目录），导致读取失败；应使用 ~/.config/compton.conf 或 /etc/xdg/compton.conf。
- 在会话启动脚本（如 ~/.xprofile、~/.xsessionrc）或 ~/.config/autostart/ 中启动方式不当，造成重复实例或环境变量缺失；应确保单实例、路径与权限正确。
- 配置文件存在语法错误（缺少括号、引号、逗号等）或参数拼写错误，Compton 会静默回退到默认或启动失败；建议使用
compton --config <file> --verbose 验证。
- 权限设置不当（如配置文件不可读），导致无法加载；推荐权限 644。
- 在 Wayland 会话中直接运行 Compton（Compton 是 X11 合成器）；需在 Xorg 会话下使用，或改用 Mutter/GNOME Shell 自带的合成器。
二 渲染与性能误区
- 后端选择不当：在支持 OpenGL 的机器上使用 xrender，性能与兼容性均受影响；优先使用 backend = glx，并确保显卡驱动正确安装。
- 过度开启特效：阴影、模糊、全局透明度对性能影响显著；在笔记本或低性能设备上可关闭阴影、减少模糊半径、只对必要窗口设透明度。
- vsync 设置一刀切：开启可减轻撕裂但可能引入卡顿或输入延迟；关闭可提升帧率但易出现撕裂。应根据显示器刷新率与显卡驱动表现实测取舍。
- 忽视驱动与依赖：未安装或使用了不合适的 NVIDIA/AMD/Intel 驱动，或未满足 libglx/libxrender 等依赖，易出现黑屏、闪烁、启动失败或高占用；应先完善驱动与依赖。
- 资源占用未控：长时间高 CPU 占用常见于复杂特效或特定应用；可通过精简特效、降低帧率、必要时用 cpulimit 限制进程占用。
三 桌面环境与兼容误区
- 与 GNOME/KDE/Xfce 等桌面环境叠加运行自合成器，导致冲突、闪烁或输入问题；应与桌面自带合成策略协调，必要时禁用其一。
- 在 GNOME 中强行用 Compton 替代 Mutter 合成，可能出现窗口装饰、拖影、缩放异常；更稳妥的做法是使用其内置合成或遵循官方推荐方案。
- 多显示器或高分屏未正确设置刷新率与 DPR，出现卡顿、撕裂或模糊；应明确 frame-rate、dpr 等参数，使之与实际显示匹配。
- 透明度/模糊规则过宽或冲突，导致面板、菜单、终端等异常透明或样式错乱；应使用精确的 opacity-rule 限定目标应用与窗口。
四 调试与生效误区
- 修改配置后未重启 Compton，或存在多个实例并存，导致“改了不生效”；应先
killall compton 再启动，或使用 --replace。
- 启动命令缺少
--config 指定自定义配置，或命令行与配置文件参数互相覆盖，难以排查；建议统一用 --config 显式指定并减少命令行杂项。
- 未查看日志与错误信息，难以定位问题；使用
compton --config <file> --verbose 输出启动与运行日志，关注报错行号与关键选项。
- 将 Compton 当作系统服务长期托管，但未处理会话生命周期与多用户场景；更稳妥的做法是在会话启动脚本中按需启动与回收。
五 快速排查清单
- 确认会话为 Xorg，并在 ~/.xprofile 或会话启动脚本中单实例启动：
compton --config ~/.config/compton.conf --verbose。
- 校验配置语法与路径：
compton --config ~/.config/compton.conf -f，确保文件权限为 644。
- 选择合理后端与特效：优先 backend = glx；如遇闪烁或高占用，先关闭 shadow/blur 再逐项恢复。
- 针对撕裂与卡顿，调整 vsync（true/false 各测），并匹配显示器 刷新率 与 frame-rate。
- 更新显卡驱动，补齐 OpenGL/渲染 相关依赖，排除黑屏与崩溃。
- 使用精确的 opacity-rule，避免全局透明导致的可读性与性能问题。
- 若需临时限制占用，可用
cpulimit -l 50 -p $(pidof compton) 做验证性限流。
