怎样排查ubuntu compton错误

在 Ubuntu 上排查 compton（或已改名为 picom） 的错误，通常可以从日志、配置、依赖、显卡驱动几个方面入手。下面按实用步骤说明。

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

很多 Ubuntu 版本里：

• compton：旧项目（已停止维护）
• picom：compton 的继任者（推荐）

查看是否安装：

which compton
which picom

如果用的是 picom，命令通常是：

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

二、前台运行查看错误信息（最重要）

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

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

常见错误示例：

• Failed to load backend
• Config parse error
• GLX error

前台运行能直接看到 具体哪一行配置或功能出问题。

三、开启调试日志

compton

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

picom

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

然后查看日志：

cat /tmp/picom.log

四、检查配置文件错误

常见配置文件位置：

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

1️⃣ 用默认配置测试

先排除配置问题：

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

如果能正常运行，说明是配置文件问题。

2️⃣ 常见配置错误

• 使用了 已废弃选项（compton → picom 变化大）
• backend = "glx" 但驱动不支持
• 阴影 / 模糊参数写错

五、显卡驱动与后端问题（非常常见）

1️⃣ 查看显卡

lspci | grep -i vga

2️⃣ 尝试不同 backend

picom --backend xrender
# 或
picom --backend glx

如果是 NVIDIA 闭源驱动：

• glx 可能不稳定
• 推荐 xrender

六、检查是否与其他 compositor 冲突

Ubuntu 自带或桌面环境可能已有 compositor：

• GNOME：Mutter
• KDE：KWin
• XFCE：自带 compositor

关闭系统自带合成器：

xfwm4 --compositor=off

或：

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

七、检查依赖是否缺失

ldd $(which picom)

常见缺失：

• libconfig
• libGL
• libxcb

安装依赖：

sudo apt install libconfig9 libgl1-mesa-dev libxcb1-dev

八、用 X11 而非 Wayland

compton / picom 不支持 Wayland

检查：

echo $XDG_SESSION_TYPE

如果是 wayland，请切换为 x11：

• 注销
• 登录界面选「Ubuntu on Xorg」

九、快速排查清单（总结）

✅ 前台运行看报错
✅ 用默认配置测试
✅ 换 backend（glx / xrender）
✅ 确认不是 Wayland
✅ 确认没有其他 compositor
✅ 查看 trace 日志

如果你愿意，可以把 具体报错信息或配置内容 发出来，我可以帮你精确定位是哪一行或哪个参数出问题。