CentOS 上 Compton 配置常见错误与排查
一 配置文件与语法问题
- 常见症状：启动时报错退出、窗口无透明/阴影、命令行提示未知选项。
- 排查要点：
- 确认配置文件路径正确：优先检查用户目录的**~/.config/compton.conf**，其次**/etc/xdg/compton.conf**。路径错误或文件缺失都会导致配置不生效。
- 校验语法与键名：不同分支/版本的 Compton 键名存在差异（例如是否支持顶层opacity = 0.95这类写法），建议对照所用版本的文档逐项核对；用命令测试配置是否能正常加载：compton --config ~/.config/compton.conf -f。
- 逐项排除法：将配置简化到最小可用集（仅保留 backend、shadow、vsync 等核心项），确认能启动后再逐步恢复其他选项，以定位问题键。
二 渲染后端与 VSync 导致的卡顿撕裂与黑屏
- 常见症状：拖动窗口卡顿、出现撕裂、特定程序/全屏场景黑屏或闪屏。
- 排查要点：
- 切换渲染后端：在glx与xrender之间尝试（如 backend = “glx” 或 “xrender”）。部分驱动/硬件在某一后端下更稳定。
- 调整 VSync：将vsync设为 true/false 进行对比测试；某些驱动与显示器组合下开启/关闭 VSync 能显著改善撕裂或卡顿。
- 降低特效开销：在问题未定位前，先关闭blur/背景模糊与阴影，确认基本合成稳定后再逐项开启。
- 性能与帧率：适当设置frame-rate（如 60），避免不必要的高帧率开销。
三 兼容性与依赖问题
- 常见症状：启动失败、段错误、日志中出现库版本/驱动相关报错、某些程序（如全屏游戏）异常。
- 排查要点：
- 显卡驱动：确保安装了正确的NVIDIA/AMD专有或开源驱动，驱动不匹配常引发合成异常。
- 系统库与链接：使用ldconfig -p检查动态库缓存，确认必要库已就位；谨慎对待glibc等核心库的升级，避免系统风险。
- 日志定位：查看 Compton 日志（如**~/.cache/compton/compton.log**）与系统日志（journalctl、/var/log/messages），从报错关键词入手（如 backend、GLX、DRI3、EGL 等）。
- 在线游戏反作弊：部分内核级反作弊与合成器冲突，必要时在游戏时临时停用 Compton。
四 服务管理与会话集成
- 常见症状：登录即退出、多会话/多显示器切换后失效、开机未自动启动。
- 排查要点：
- 正确启动方式：在会话启动脚本（如 Openbox 的 autostart、i3 的 config）中启动，或使用 Systemd 用户服务；避免无图形环境（如 multi-user.target）下直接启动。
- Systemd 最小示例（用户级）：创建**~/.config/systemd/user/compton.service**，内容示例：
- [Unit] Description=Compton Window Composer After=xorg.service
- [Service] ExecStart=/usr/bin/compton --config %h/.config/compton.conf Restart=on-failure
- [Install] WantedBy=default.target
- 启用：systemctl --user daemon-reload && systemctl --user enable --now compton
- 避免重复实例：启动前先结束旧进程（如 killall compton），或使用前台调试模式观察输出。
- 运行与验证：用ps -e | grep compton确认进程存在；修改配置后重启 Compton 使其生效。
五 快速排查清单与最小可用配置