Debian如何调试Compton

在 Debian 上调试 Compton（或它的继任者 picom） 的常用方法如下，按“从简单到深入”的顺序整理，适合排查透明、闪烁、花屏、性能等问题。

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

Debian 新版本里 Compton 已基本被 picom 取代：

compton --version
picom --version

• 如果只有 picom，请直接用 picom
• Debian 10 及以后 推荐用 picom

二、用命令行前台运行（最重要）

不要后台运行，否则看不到错误信息。

picom --no-daemon --verbose

或（老 compton）：

compton --no-daemon -f -D 5

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

• GLX 错误
• backend 不支持
• 配置文件语法错误

三、指定 backend 调试（常见坑）

picom --backend xrender

或：

picom --backend glx

如果某个 backend 黑屏 / 花屏：

• xrender：稳定但功能少
• glx：功能多但依赖显卡驱动

四、使用最小配置测试

先排除配置文件问题：

mv ~/.config/picom.conf ~/.config/picom.conf.bak
picom --no-daemon --verbose

如果正常，再逐步恢复配置。

五、打开调试日志

picom

picom --no-daemon --log-level trace

或写入文件：

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

compton

compton --no-daemon -f -D 5 --debug

六、检查显卡驱动（非常重要）

glxinfo | grep "OpenGL renderer"

常见问题：

• Intel / AMD：一般没问题
• NVIDIA：
  • 闭源驱动 ✅
  • nouveau ❌ 容易出问题

NVIDIA 推荐参数：

picom --backend glx --vsync

或：

picom --backend xrender

七、常见参数调试示例

1️⃣ 透明 / 阴影异常

picom \
  --no-fading-openclose \
  --no-fading-destroyed-argb \
  --shadow-exclude "class_g = '.*'"

2️⃣ 闪烁 / 撕裂

picom --vsync

或：

picom --backend glx --vsync opengl-swc

八、检查是否被其他 compositor 冲突

ps aux | grep -E "compton|picom|xfwm4|mutter|kwin|openbox"

常见冲突：

• XFCE：关闭自带 compositor
• GNOME：不要手动启动 picom
• i3 / bspwm：适合用 picom

九、生成并修改配置文件

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

然后重点检查：

• backend
• vsync
• shadow
• fade
• opacity-rule

十、Debian 常见组合推荐

Intel / AMD + i3

picom --backend glx --vsync

NVIDIA

picom --backend xrender

老机器

picom --backend xrender --no-fading-openclose

十一、如果仍然无法解决

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

1. Debian 版本
2. 显卡型号 + 驱动
3. 桌面环境 / WM
4. picom 版本
5. 报错日志（--log-level trace）

如果你愿意，我也可以 帮你逐行审查 picom.conf。