如何调试linux compton错误

在 Linux 上调试 compton（或它的继任者 picom）错误，通常可以按下面几个步骤系统地进行。

一、确认你用的是什么

先确认你运行的是哪个：

which compton
which picom

很多发行版已用 picom 替代 compton。命令和配置基本通用，但报错信息可能不同。

二、前台运行并查看日志（最关键）

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

compton --verbose
# 或
picom --verbose

如果已经有实例在跑：

killall compton
compton --verbose

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

• 配置文件语法错误
• backend 不支持（glx / xrender）
• 无法连接 X server

三、使用最小配置测试

新建一个最小配置：

cat > ~/.config/compton/min.conf <<EOF
backend = "xrender";
EOF

运行：

compton --config ~/.config/compton/min.conf --verbose

如果这样能跑，说明是原配置有问题。

四、常见错误及解决方法

1. 配置文件错误

典型报错：

Parse error at line XX

检查：

• 是否少了分号 ;
• 是否用了旧参数（compton → picom 改名很多）

示例（picom）：

shadow = true;
fade = true;
backend = "glx";

2. GLX / OpenGL 错误

报错示例：

Failed to initialize GLX

尝试：

compton --backend xrender

或在配置中：

backend = "xrender";

虚拟机 / 老显卡常见此问题。

3. 多显示器 / 多显卡问题

可尝试指定屏幕：

compton --display :0

或禁用某些功能：

use-damage = false;

4. 与窗口管理器冲突

如果你用的是：

• i3 / bspwm / awesome / openbox

确保：

• 没有同时启用其他合成器（xfwm、kwin、mutter）

查看：

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

五、查看系统日志

journalctl -xe | grep compton

或：

dmesg | tail

六、调试性能问题（不是崩溃）

如果是卡顿：

picom --benchmark

或：

benchmark = 10;

七、升级或替换

如果问题持续：

sudo apt remove compton
sudo apt install picom

picom 是活跃维护版本。

八、你可以这样向我求助

如果你愿意，可以把下面信息发我，我可以直接帮你改配置：

1. 发行版（如 Arch / Ubuntu / Debian）
2. 窗口管理器（i3 / bspwm 等）
3. 完整报错信息（compton --verbose 输出）
4. 你的配置文件内容

我可以一步一步帮你定位。