怎样调试debian compton错误

在 Debian 上调试 compton（或它的继任者 picom）错误，通常可以从日志、配置、依赖、显示环境几个方向入手。下面是一套比较系统的排查方法。

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

Debian 新版通常已用 picom（compton 的 fork）：

which compton picom
compton --version
picom --version

如果你装的是 compton 但问题很多，建议直接换 picom：

sudo apt install picom

二、前台运行并查看错误输出（最重要）

不要直接后台启动，先手动运行看报错：

compton --config ~/.config/compton.conf
# 或
picom --config ~/.config/picom.conf

如果有错误，通常会直接打印在终端。

开启调试日志

picom --log-level trace --log-file /tmp/picom.log

然后查看：

cat /tmp/picom.log

三、常见错误及对应解决办法

1. “No composite manager running” / 黑屏

原因：

• 没有开启 compositing 支持
• 在 Wayland 下运行（compton 只支持 X11）

检查当前会话：

echo $XDG_SESSION_TYPE

如果是 wayland，compton/picom 不可用。

解决：

• 登出，选择 GNOME on Xorg / XFCE / Openbox
• 或改用 Wayland 原生合成器

2. 配置文件语法错误

compton/picom 对配置很敏感。

测试配置是否有效：

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

常见错误：

• 用了 true/false 而不是 true / false
• 多了逗号
• 参数名拼错（如 shadow-exclude vs shadow-exclude-list）

最小可用配置示例（picom）：

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

3. OpenGL / GLX 错误

报错如：

Failed to create GLX context

解决思路：

glxinfo | grep OpenGL

如果没有输出，说明驱动有问题。

尝试：

• 安装 Mesa：

sudo apt install mesa-utils libgl1-mesa-dri

• 切换 backend：

backend = "xrender";

4. NVIDIA 显卡问题

NVIDIA 闭源驱动常见：

• 闪烁
• 透明失效

尝试：

backend = "glx";
glx-no-stencil = true;

或直接使用 xrender。

5. 多显示器 / 分辨率问题

现象：

• 某个屏幕不透明
• 鼠标残影

可尝试：

unredir-if-possible = false;

四、systemd / 自启动调试

如果你用 .desktop 或 systemd 启动：

查看是否真的在跑

ps aux | grep picom

手动杀掉再启动

pkill picom
picom &

五、快速排查清单（推荐顺序）

1. echo $XDG_SESSION_TYPE → 必须是 x11
2. 前台运行 picom 看报错
3. 用最小配置测试
4. 换 xrender backend
5. 看 /tmp/picom.log

如果你愿意，可以把具体报错信息或你的配置内容贴出来，我可以直接帮你指出问题在哪一行。