ubuntu compton怎么调试日志

在 Ubuntu 上调试 Compton（或已更名为 picom） 的日志，一般从命令行启动 + 日志输出 + 配置校验入手。下面按实用顺序说明。

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

很多 Ubuntu 上实际是 picom（compton 的 fork）：

which compton picom
compton --version
picom --version

新系统建议直接用 picom，调试方式基本一致。

二、前台运行并查看日志（最重要）

不要通过桌面自动启动，先手动前台运行：

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

或 compton：

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

参数说明：

• -f：前台运行（日志直接输出到终端）
• --config：指定配置文件

这样你能立刻看到：

• 配置错误
• backend 问题
• GL / Xrender 错误
• 屏幕撕裂、崩溃原因

三、提高日志详细程度

1. 使用 debug 模式

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

或：

picom -D 5

（-D 是 log level，数字越大越详细）

2. 常见日志级别

四、常见错误与排查

1. backend 问题

日志中常见：

Failed to initialize backend

解决：

picom --backend xrender

或

picom --backend glx

2. 配置文件语法错误

Compton / picom 对 YAML 很严格：

检查：

• 缩进是否空格
• 是否用了 tab
• 布尔值是 true / false 不是 yes / no

手动校验：

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

3. 与桌面环境冲突

如果你用的是：

• GNOME（默认已有合成器）
• KDE（KWin）

先关掉系统合成器再测：

killall picom

五、写日志到文件（后台调试）

picom --config ~/.config/picom.conf --debug > ~/picom.log 2>&1

然后：

tail -f ~/picom.log

六、systemd / 自动启动调试

如果你用 ~/.xprofile 或 systemd：

picom --config ~/.config/picom.conf --debug >> ~/.cache/picom.log 2>&1 &

登录后查看：

cat ~/.cache/picom.log

七、快速排错清单 ✅

• [ ] 前台运行看日志
• [ ] 用 --debug
• [ ] 换 backend（glx / xrender）
• [ ] 校验配置文件
• [ ] 确认没有其他合成器

如果你愿意，可以把 你的 picom.conf + 报错日志贴出来，我可以直接帮你定位问题。