debian compton怎么排错

在 Debian 上排查 Compton（常作为 picom 的前身/分支） 的问题，可以按下面系统的思路来做。

一、确认你用的是哪个 compositor

Debian 上常见情况：

• 老包：compton
• 新包：picom（compton 的 fork，推荐）

先确认：

which compton
which picom

建议直接用 picom（更稳定、文档更好）。

二、最基本的启动与排错方式

1. 手动前台启动（最关键）

不要后台启动，前台看报错：

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

如果有错误，会直接打印在终端。

2. 打开调试日志

picom --log-level DEBUG

或写入文件：

picom --log-level DEBUG -o /tmp/picom.log

三、常见错误与解决方法

1. 已经有一个 compositor 在运行

报错类似：

Another composite manager is already running

解决：

ps aux | grep -E 'compton|picom|xfwm|mutter|kwin'
kill 对应进程

注意：GNOME/KDE 自带 compositor，不要重复开

2. 配置文件路径或语法错误

常见路径：

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

检查语法：

picom --config ~/.config/picom.conf --show-uncovered

或简化为最小配置测试：

backend = "glx";
vsync = true;

3. OpenGL / GLX 问题（非常常见）

报错：

Failed to create GLX context

解决思路：

• 确认有 3D 加速：

glxinfo | grep OpenGL

• 改用 xrender：

backend = "xrender";

• 或禁用 vsync：

vsync = false;

4. NVIDIA 显卡问题

NVIDIA 常见问题：

• 透明度异常
• 窗口闪烁

建议配置：

backend = "glx";
glx-no-stencil = true;
vsync = "opengl-swc";

并确保：

nvidia-settings

里 Allow Flipping 开启

5. 窗口管理器冲突

Compton 只适合：

• i3
• Openbox
• Fluxbox
• Awesome

不适合：

• GNOME（mutter）
• KDE（kwin）

四、开机自启排错（i3 / Openbox 等）

i3 示例

exec --no-startup-id picom

如果没启动：

journalctl -xb | grep picom

五、快速“最小可用配置”测试

backend = "xrender";
vsync = false;
opacity-rule = [ "90:class_g = 'Firefox'" ];

能跑再逐步加功能。

六、收集信息给我（方便精准排错）

你可以贴出：

1. Debian 版本（cat /etc/os-release）
2. 显卡型号
3. 窗口管理器
4. 报错信息（终端输出）
5. 配置文件内容

我可以直接帮你改到能跑 ✅