debian compton怎样调试

在 Debian 上调试 compton（窗口合成器），一般可以从日志输出、配置文件、运行参数、依赖和常见坑几个方面入手。下面按实用顺序说明。

一、先确认 compton 是否在运行

ps aux | grep compton

如果没有进程，说明没启动或被桌面环境接管了。

手动运行测试：

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

二、开启调试日志（最重要）

1️⃣ 前台运行 + 调试输出

compton -b --log-level trace --log-file /tmp/compton.log

或前台运行（不后台）：

compton --log-level debug

常用日志级别：

• info
• warn
• error
• debug
• trace（最详细）

三、常见启动参数（调试用）

compton \
  --config ~/.config/compton.conf \
  --backend glx \
  --vsync opengl \
  --paint-on-overlay \
  --log-level debug

如果你用的是 picom（compton 分支）：

picom --legacy-backends --log-level debug

四、检查配置文件

示例最小配置（先排除配置问题）

backend = "glx";
vsync = true;
shadow = false;

然后逐步加功能。

五、常见错误与解决方法

1️⃣ OpenGL / GLX 错误

日志常见：

Failed to initialize GLX

解决：

glxinfo | grep OpenGL

确保：

• 装了 mesa-utils
• 驱动正常（Intel / AMD / NVIDIA）

NVIDIA 用户建议：

backend = "xrender";

2️⃣ 黑屏 / 闪屏

尝试：

unredir-if-possible = false;

或：

paint-on-overlay = true;

3️⃣ 透明失效

确认：

• 窗口管理器支持 compositing
• 没被其他 compositor 占用（如 xfwm、mutter）

检查：

xprop | grep _NET_WM_WINDOW_OPACITY

4️⃣ Debian 上包名问题

Debian 旧版本：

apt install compton

新版 Debian（Bookworm+）：

apt install picom

picom 是 compton 的继任者。

六、和桌面环境冲突

XFCE

关闭自带 compositor：

设置 → 窗口管理器微调 → 合成器 → 关闭

GNOME / KDE

不建议用 compton，冲突严重。

七、快速排错清单 ✅

• [ ] 日志是否有 error / trace
• [ ] 是否只有一个 compositor
• [ ] backend 是否匹配显卡
• [ ] 配置文件语法是否正确
• [ ] Debian 版本 + compton/picom 版本

如果你愿意，可以贴：

• Debian 版本
• compton --version
• /tmp/compton.log 关键错误

我可以帮你精准定位问题。