如何调试debian compton

在 Debian 上调试 compton（现在多数发行版已更名为 picom，但命令和配置基本兼容）通常会涉及日志、配置校验、后端选择、显卡驱动、合成器冲突等方面。下面按“从快到慢、从常见到深入”的顺序说明。

一、基本调试思路（先看这个）

1. 前台运行，看报错

不要直接后台启动，先看输出：

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

或（picom）：

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

常见错误会直接打印在终端，例如：

配置文件语法错误
后端不支持
OpenGL 初始化失败

2. 开启调试日志

compton --config ~/.config/compton.conf --log-level debug

或

picom --log-level debug

日志会显示：

使用的后端（xrender / glx / egl）
窗口类型
阴影 / 透明度处理情况

二、常见问题与对应调试方法

1. 黑屏 / 闪屏 / 卡顿

可能原因

与其他合成器冲突（xfwm4、mutter、kwin）
后端选择错误

调试

compton --backend xrender
compton --backend glx
compton --backend egl

逐一测试，找到稳定的一个。

2. 配置不生效

检查

配置文件路径是否正确

ls ~/.config/compton.conf

是否用了 --config 但路径错
是否同时有 picom.conf

校验语法

compton --config ~/.config/compton.conf --dry-run

3. 与窗口管理器冲突

Debian 常见环境：

XFCE（xfwm4 自带合成）
GNOME（mutter）
KDE（kwin）

解决

XFCE：
设置 → 窗口管理器微调 → 关闭“合成器”
GNOME/KDE：
不建议用 compton

4. OpenGL / GLX 问题

调试

glxinfo | grep OpenGL

确认：

驱动正常
不是 llvmpipe（软件渲染）

如为软件渲染：

安装正确显卡驱动（nvidia / amdgpu / intel）

5. 高 CPU / 高内存

调试

compton --vsync none

或关闭：

阴影
模糊（blur）

三、推荐的最小调试配置

~/.config/compton.conf

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

然后逐步开启功能。

四、Debian 特有注意点

Debian 默认仓库中：
- compton 已废弃
- 推荐安装：
```
sudo apt install picom
```
使用 picom 代替 compton 命令

五、快速排查清单（实用）

✅ 是否前台运行看报错
✅ 是否只运行一个合成器
✅ 是否 backend 测试过
✅ 是否驱动正常
✅ 是否配置路径正确

如果你愿意，可以告诉我：

Debian 版本（11 / 12）
桌面环境（XFCE / GNOME / KDE）
显卡型号
具体现象（黑屏 / 卡 / 闪）

我可以直接帮你写一份可用配置或定位问题。