debian compton如何排查错误

在 Debian 上排查 Compton（或已更名为 Picom） 的问题，可以按下面系统化的步骤来定位和解决。

一、确认你用的是 compton 还是 picom

Debian 上常见两种情况：

• 老包：compton
• 新包：picom（compton 的 fork，推荐）

查看是否已安装：

which compton
which picom

如果是 picom，以下命令把 compton 换成 picom 即可。

二、前台运行，查看错误信息（最重要）

不要后台启动，先在前台运行看输出：

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

或：

picom --config ~/.config/picom.conf

常见错误示例：

• 配置文件语法错误
• backend 不支持（如 glx 不可用）
• 显示器/驱动问题

三、查看日志

1. 使用 --log-file

compton --log-file /tmp/compton.log

然后：

cat /tmp/compton.log

2. 系统日志

journalctl -xe

或（旧系统）：

cat /var/log/Xorg.0.log | grep -i compton

四、检查配置文件

常见配置文件位置

• ~/.config/compton.conf
• ~/.config/picom.conf
• /etc/xdg/compton.conf

验证语法

compton 对语法很敏感，推荐最小配置测试：

backend = "xrender";
vsync = false;

然后逐步加功能。

五、检查运行环境

1. 是否在 X11 下

Compton 不支持 Wayland

echo $XDG_SESSION_TYPE

如果是 wayland，需要换合成器（如 wayfire、sway）。

2. 显卡驱动是否正常

glxinfo | grep "OpenGL renderer"

如果报错，说明驱动有问题。

六、常见错误与解决

1. 黑屏 / 闪屏

• 尝试：

backend = "xrender";
vsync = false;

2. 透明无效

• 确认窗口管理器支持 compositing
• 确认：

opacity-rule = [ "90:class_g = '.*'" ];

3. 启动后立刻退出

• 通常是配置错误
• 用前台运行查看报错

4. 高 CPU 占用

• 关闭 shadow / blur
• 使用 xrender 而非 glx

七、调试参数（非常有用）

compton --show-all-events
compton --debug

八、推荐排查顺序（总结）

1. 前台运行 compton
2. 看终端报错
3. 使用最小配置
4. 确认 X11 + 驱动正常
5. 看 log 文件
6. 逐步加配置

如果你愿意，可以把：

• 你的 Debian 版本
• 显卡型号
• 桌面环境（XFCE / i3 / Openbox 等）
• compton 报错信息

贴出来，我可以直接帮你定位问题。