debian compton怎样排查错误

在 Debian 上排查 compton（或已更名后的 picom） 的问题，可以按下面几个步骤系统来。

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

Debian 里：

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

查看是否已安装：

which compton
which picom

如果装的是 compton 但想用新功能，建议：

sudo apt install picom

二、从命令行手动启动（最关键）

不要直接靠桌面环境自动启动，先在终端运行：

compton --diagnostics
# 或
picom --diagnostics

这一步会打印：

• 配置文件路径
• 后端（glx / xrender）
• 是否支持各特效
• 明显错误（如缺少扩展）

如果有错误，往往会直接显示红色/黄色提示。

三、开启调试日志

compton --debug
# 或
picom --debug

观察是否有：

• Failed to load backend
• Cannot open display
• another compositor is running

四、检查是否有其他 compositor 冲突

常见冲突：

• xfwm4 自带合成
• mutter
• kwin
• xcompmgr

查看正在运行的 compositor：

ps aux | grep -E "compton|picom|xcompmgr|kwin|mutter|xfwm"

如果有多个，先杀掉：

killall compton picom xcompmgr

五、确认 X11 还是 Wayland

compton / picom 只支持 X11。

检查当前会话：

echo $XDG_SESSION_TYPE

如果是 wayland：

• compton 无效
• 应使用桌面自带合成（如 GNOME / KDE）

六、检查配置文件

常见配置文件位置：

~/.config/compton.conf
~/.config/picom.conf

问题排查：

• 语法错误会导致直接退出
• 可先临时删掉配置测试：

mv ~/.config/compton.conf ~/.config/compton.conf.bak
compton

七、显卡 / 驱动相关问题

1. 使用 glx 后端失败

尝试：

compton --backend xrender

2. NVIDIA 用户

可能需要：

compton --backend glx --vsync opengl

3. 缺少 32 位库（少见）

sudo apt install libgl1-mesa-glx

八、桌面环境自动启动失败

如果你用 .desktop 自启：

~/.config/autostart/compton.desktop

内容示例：

[Desktop Entry]
Exec=picom
Type=Application

排查：

• 看 ~/.xsession-errors
• 看 journal：

journalctl -b | grep picom

九、常见症状速查表

十、最小可用测试命令

picom --backend xrender --no-fading-openclose

如果这样能用，再逐步加配置。

如果你愿意，可以贴出：

• Debian 版本
• 桌面环境（XFCE / i3 / KDE？）
• picom --diagnostics 输出

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