ubuntu compton如何调试错误

在 Ubuntu 上调试 Compton（或已演进为 Picom） 的报错，一般按下面步骤来比较高效。

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

现在大多数 Ubuntu 仓库里的 compton 实际已是 picom 的分支。

which compton
which picom
compton --version
picom --version

如果输出是 picom，建议直接用 picom 命令和配置。

二、前台运行，看实时错误（最重要）

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

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

或完全不使用配置，排除配置问题：

compton --no-config
# 或
picom --no-config

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

• 配置文件语法错误
• 渲染后端不支持（glx / xrender）
• 缺少依赖（libconfig 等）

三、开启调试日志

Compton

compton --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

验证语法（如果是 libconfig 格式）：

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

或：

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

如果有语法错误，这里会直接报错。

五、检查渲染后端

尝试不同后端排查：

compton --backend xrender
compton --backend glx

或：

picom --backend xrender
picom --backend glx

如果你用的是 NVIDIA 闭源驱动，glx 经常有问题，可优先试 xrender。

六、确认运行环境

Compton 只支持 X11，不支持 Wayland。

检查当前会话：

echo $XDG_SESSION_TYPE

如果是 wayland，Compton 无法工作，需要：

• 注销
• 选择 “Ubuntu on Xorg”

七、常见错误速查

1. Another composite manager is already running

说明已有 compositor（如 mutter、kwin、xfwm 自带）。 解决：

• 关闭系统自带合成器
• 或在桌面环境中禁用

2. 黑屏 / 闪烁

尝试：

vsync = false;

或切换 backend。

3. 透明失效

确认：

opacity-rule = [ ... ];

或窗口管理器是否支持。

八、最小可用配置示例

backend = "xrender";
vsync = true;
shadow = false;
fade = false;

九、如果仍无法解决

请提供以下信息，我可以帮你具体分析：

1. Ubuntu 版本
2. 桌面环境（GNOME / KDE / XFCE）
3. 显卡驱动
4. 完整错误日志（/tmp/picom.log）
5. 你的配置文件内容

我可以一步步帮你定位。