debian compton怎么排查错误

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

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

Debian 新版中：

• compton 已停止维护
• 替代为 picom

检查是否安装：

which compton
which picom

如果是 picom，下文命令中把 compton 换成 picom。

二、前台运行，看真实报错（最重要）

不要直接后台启动，先前台看日志：

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

或：

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

常见错误类型：

• 配置文件语法错误
• OpenGL 后端失败
• 与窗口管理器冲突

三、使用调试模式

compton -b --diagnostics

或：

picom --diagnostics

会输出：

• 后端（backend）
• 渲染器
• 显示器信息
• 是否支持阴影 / 透明

四、检查配置文件

常见路径：

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

典型错误

1. 使用了已废弃选项（如 shadow-exclude 写法错误）
2. 重复定义 key
3. YAML 格式错误（picom 新版本用 YAML）

建议

• 先 删掉配置文件测试

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

如果正常，说明是配置问题。

五、后端问题（最常见）

1. OpenGL 失败

尝试切换后端：

compton --backend xrender

或（picom）：

picom --backend xrender

2. NVIDIA 用户

可能需要：

compton --backend glx --vsync opengl

六、窗口管理器冲突

compton 不能和以下同时用：

• 其他合成器（kwin、mutter、xfwm 自带的）
• 某些 WM 自带 compositing

检查：

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

七、日志与系统信息

Xorg 日志

cat ~/.local/share/xorg/Xorg.0.log

或：

journalctl -xe

OpenGL 支持

glxinfo | grep OpenGL

八、自动启动失败排查

如果你在：

• .xinitrc
• autostart
• i3/config

确保：

exec compton &

放在 WM 启动之后

九、常见症状速查表

如果你愿意，可以贴：

• Debian 版本
• 桌面 / WM
• compton 或 picom 版本
• 报错日志

我可以直接帮你定位问题。