怎样调试ubuntu compton

下面按从入门到进阶的思路，讲一下在 Ubuntu 上调试 compton（或 picom） 的常见方法和常见问题排查。

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

很多 Ubuntu 教程里说的 compton，实际已经停止维护，社区版本叫 picom。

which compton
which picom

• 有 picom → 用 picom
• 只有 compton → 可以继续用，但建议迁移

二、最基础的调试方式（必做）

1️⃣ 前台运行，看日志

不要后台启动，先直接运行：

picom --experimental-backends

或

compton -f

观察终端输出，常见错误：

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

2️⃣ 使用调试参数

picom --log-level trace

或

compton -D 5 --show-all-errors

三、配置文件调试（最重要）

默认配置文件位置

~/.config/picom.conf

如果没有：

mkdir -p ~/.config
touch ~/.config/picom.conf

最小可用配置（排错用）

backend = "glx";
vsync = true;

然后逐步加功能。

四、常见故障 & 解决方法

❌ 黑屏 / 闪屏

原因：backend 不对
尝试切换：

backend = "xrender";

或

backend = "glx";

❌ 透明无效

确认：

• 窗口管理器支持 compositing（i3 / Openbox 都支持）
• 没有多个 compositor 同时运行

ps aux | grep -E "compton|picom|xcompmgr"

❌ CPU 占用高

关闭不必要的特效：

shadow = false;
fade = false;

❌ 启动就崩溃

用这个命令看详细错误：

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

五、开机自启调试（Ubuntu）

i3 / Openbox

在配置里加：

exec picom

GNOME（不推荐）

GNOME 自带 compositor，compton 容易冲突。

六、快速排错清单 ✅

• [ ] 是否前台运行过
• [ ] 是否看日志
• [ ] 是否只运行一个 compositor
• [ ] backend 是否切换测试
• [ ] 配置是否从最小开始

如果你愿意，可以把：

• Ubuntu 版本
• 桌面环境（GNOME / KDE / i3 / Openbox）
• picom.conf
• 报错日志

发给我，我可以直接帮你改配置。