如何排查linux compton配置

在 Linux 上排查 compton（或其继任者 picom）配置问题，可以按下面步骤系统性进行。

一、确认 compton 是否正在运行

ps aux | grep compton
# 或
pgrep -a compton

如果没运行，先手动启动看报错：

compton --config ~/.config/compton.conf

若使用 picom：
picom --config ~/.config/picom.conf

二、使用命令行调试（最关键）

前台运行并打开日志：

compton --config ~/.config/compton.conf --log-level trace --log-file /tmp/compton.log

或：

compton -b=false --verbose

常见错误包括：

配置文件语法错误
后端（backend）不支持
OpenGL / XRender 初始化失败

三、检查配置文件位置和格式

1. 配置文件路径

compton 默认读取：

~/.config/compton.conf

picom 默认：

~/.config/picom.conf

也可以用：

compton --config /path/to/compton.conf

2. 配置语法检查

compton 使用 libconfig 格式（不是 YAML/JSON）：

✅ 正确示例：

backend = "glx";
shadow = true;
shadow-radius = 12;
fade = true;

❌ 错误示例：

backend: glx      # 错误
shadow = true     # 缺少分号在某些版本会警告

四、常见问题排查清单

1. 透明/阴影不生效

确认窗口管理器支持 compositing（如 i3、Openbox）
确认未和其他 compositor 冲突（如 xcompmgr）

ps aux | grep -E "compton|picom|xcompmgr"

2. 黑屏 / 卡顿

尝试切换 backend：

backend = "xrender";

或

backend = "glx";

并禁用部分特效测试：

shadow = false;
fade = false;

3. OpenGL 报错

检查驱动：

glxinfo | grep OpenGL

若无输出，说明缺少 3D 加速。

五、最小化配置测试（推荐）

先用最小配置排除问题：

backend = "xrender";
shadow = false;
fade = false;

逐步加功能。

六、与窗口管理器集成

i3 示例

exec --no-startup-id compton --config ~/.config/compton.conf

日志位置

~/.xsession-errors

七、compton vs picom

⚠️ compton 已停止维护
✅ 推荐使用 picom

迁移：

配置基本兼容
命令：picom 代替 compton

八、快速排查总结

# 1. 是否运行
pgrep -a compton

# 2. 前台调试
compton --config ~/.config/compton.conf --verbose

# 3. 最小配置
backend = "xrender";

# 4. 检查冲突
ps aux | grep compositor

如果你愿意，可以贴出你的 compton 配置 + 发行版 + 桌面环境，我可以帮你逐行检查。