debian compton怎么调试

在 Debian 上调试 Compton（现在更常见的是其分支 Picom，Compton 已基本停止维护），通常从日志、配置、渲染后端、 compositor 冲突几个方面入手。下面按实用顺序说明。

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

Debian 新版一般装的是 picom：

which compton picom
compton --version
picom --version

如果输出是 picom，下面命令把 compton 换成 picom 即可。

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

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

compton --config /dev/null

或指定你的配置：

compton -b=false --config ~/.config/compton.conf

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

• 配置语法错误
• 后端不支持（glx / xrender）
• 与已有 compositor 冲突

三、开启调试日志

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

然后查看：

tail -f /tmp/compton.log

关键日志字段：

• backend
• vsync
• shadow
• window rules

四、检查是否有多个 Compositor 冲突

Debian + 桌面环境常见冲突：

• XFCE：自带 compositor
• KDE / GNOME：自带
• 其他：xcompmgr

关闭系统自带 compositor 后再试。

XFCE 示例：

设置 → 窗口管理器微调 → 合成器 → 关闭

检查是否在运行：

ps aux | grep -E 'compton|picom|xcompmgr|kwin|mutter'

五、最小化配置调试法（推荐）

先用一个最小配置排除问题：

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

运行：

compton --config minimal.conf

如果正常，再逐步加功能。

六、后端调试（glx / xrender）

尝试 xrender（最稳）

backend = "xrender";

尝试 glx（性能更好但易出错）

backend = "glx";
glx-no-stencil = true;

检查 OpenGL：

glxinfo | grep OpenGL

若无 glxinfo：

sudo apt install mesa-utils

七、窗口规则调试（黑屏 / 闪屏）

示例：排除某个窗口：

opacity-rule = [
  "0:class_g = 'Firefox'"
];

或排除全屏：

unredir-if-possible = true;

八、常见故障速查

1. 黑屏 / 登录后无界面

• 关掉 fade
• 用 xrender
• 检查 NVIDIA / 驱动

2. 高 CPU

• 关 shadow
• 关 blur
• 用 xrender

3. 闪屏

• 改 vsync

vsync = "opengl-swc";

或

vsync = false;

4. NVIDIA 用户

backend = "glx";
glx-no-stencil = true;
vsync = false;

九、Debian 安装 / 重装

sudo apt install compton
# 或
sudo apt install picom

十、建议（重要）

✅ 新系统直接用 picom

sudo apt install picom
picom --config ~/.config/picom.conf

Compton 已停止维护，很多 bug 在 picom 已修复。

如果你愿意，可以把：

• Debian 版本
• 桌面环境（XFCE / KDE / 无桌面）
• 显卡 & 驱动
• 你的 compton 配置

发出来，我可以帮你精准定位问题。