Debian 上 Compton 配置错误的排查与修复指南
一、快速定位问题
- 检查运行状态：确认 Compton 是否在运行，若未运行可先手动启动以便观察输出。示例：
ps -e | grep compton 与 compton &。
- 查看日志：优先查看用户缓存日志 ~/.cache/compton/compton.log；若通过 systemd 管理，可用
journalctl -u compton.service -b 查看服务日志。
- 配置文件位置：常见路径为 ~/.config/compton.conf，也可能在 /etc/xdg/compton.conf 或 ~/.config/compton/config。不确定时先查找或创建用户级配置。
- 逐项回退：将配置中最近修改的选项逐项注释或恢复默认值，定位触发问题的具体项。
二、高频配置错误与修复
- 后端选择不当：将 backend 调整为与驱动匹配的 glx 或 xrender；若 glx 导致崩溃或撕裂，可改用 xrender 提升兼容性。
- 特效冲突：关闭或简化 shadow、opacity、fade 等特效以排除渲染问题。
- 垂直同步设置：vsync 与驱动/显示器不匹配会引发卡顿或闪烁，尝试切换 true/false 对比。
- 桌面环境冲突：GNOME/KDE 等自带或推荐的合成器可能与 Compton 冲突，必要时在桌面设置中关闭自带合成器，仅保留一个。
- 配置文件语法/键名错误：常见为键名拼写错误、缺少引号或括号、层级错误；用最小化配置验证后再逐项恢复。
- 权限与路径：确保配置文件可被当前用户读取，路径正确；必要时使用绝对路径启动并指定配置：
compton --config ~/.config/compton.conf。
三、最小可用配置模板
- 建议先用以下最小化配置验证系统与驱动是否正常，再逐步开启特效：
backend = "glx"
vsync = true
shadow = false
opacity = false
fade-in-step = 0.03
fade-out-step = 0.03
- 保存为 ~/.config/compton.conf 后，重启 Compton 生效。
四、重启与自启动的正确方式
- 手动重启：先结束旧进程再启动，便于观察输出。示例：
killall compton && compton --config ~/.config/compton.conf &。
- systemd 管理（可选）：创建服务文件 /etc/systemd/system/compton.service，内容示例：
[Unit]
Description=Compton Window Composer
After=xorg.service
[Service]
ExecStart=/usr/bin/compton --config /home/你的用户名/.config/compton.conf
Restart=on-failure
User=你的用户名
[Install]
WantedBy=multi-user.target
- 启用与启动：
sudo systemctl daemon-reload && sudo systemctl enable --now compton。
- 注意：多数桌面会话已由会话管理器自动启动 Compton，手动启用 systemd 服务可能与会话启动方式冲突，导致重复实例或无法启动，优先使用会话自启动或按桌面环境文档配置。
五、仍未解决时的进阶检查
- 更新与重装：执行
sudo apt update && sudo apt install --reinstall compton 更新到仓库最新版本并修复缺失文件。
- 显卡驱动：显卡驱动异常会引发合成器崩溃或黑屏，确保 NVIDIA/AMD/Intel 驱动安装正确并更新到合适版本。
- 资源与冲突：用
top 等工具观察 CPU/内存 占用，排查其他程序抢占或系统资源不足；同时确认仅运行一个合成器。