怎样调试debian compton配置

在 Debian 上调试 compton（或已演进为 picom） 配置，通常遵循“先跑起来 → 看日志 → 隔离问题 → 逐步调参”的思路。下面按实用顺序说明。

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

Debian 里：

• 旧包名：compton
• 新包名：picom（兼容 compton 配置，但更活跃）

which compton picom
compton --version
picom --version

建议新系统直接用 picom。

二、用命令行手动启动（最关键）

不要直接靠窗口管理器自动启动，先手动跑：

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

或（compton）：

compton --config ~/.config/compton.conf -D 3 --debug

观察：

• 是否报错（配置语法错误最常见）
• 是否有 backend 提示（xrender / glx）

三、使用最小可用配置

新建一个最小配置测试：

# ~/.config/picom.conf
backend = "glx";
glx-no-stencil = true;
vsync = true;

然后：

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

如果能跑，再逐步加功能（阴影、模糊、淡入淡出）。

四、常见调试点

1. 黑屏 / 闪屏

尝试：

backend = "xrender";

或：

unredir-if-possible = false;

2. 透明无效

确认：

• 程序本身支持透明（终端、文件管理器）
• 没有 opacity-rule 误伤

测试：

picom --config ~/.config/picom.conf --opacity-rule "90:class_g = '.*'"

3. 阴影异常

调试阴影：

shadow = true;
shadow-radius = 12;
shadow-offset-x = -2;
shadow-offset-y = -2;
shadow-opacity = 0.5;

排除：

shadow-exclude = [
  "name = 'Notification'",
  "class_g = 'Conky'"
];

4. 模糊不生效

blur-method = "gaussian";
blur-strength = 10;

注意：

• xrender 不支持 blur
• 必须用 glx 或 xr_glx_hybrid

5. 性能差 / 卡顿

vsync = false;
glx-no-rebind-pixmap = true;

或限制刷新：

picom --fps-limit 60

五、日志与排错命令

查看 compton 输出

picom --config ~/.config/picom.conf --log-level trace

检查 X 扩展

glxinfo | grep -i opengl

六、和窗口管理器配合

如果你用：

• i3 / bspwm / openbox

确保：

• 只启动 一个 compositor
• 没有冲突的 xcompmgr

检查：

ps aux | grep -E "picom|compton|xcompmgr"

七、Debian 特定注意

• Wayland 下 compton 不可用
• 使用 X11 会话
• NVIDIA 用户建议：

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

八、快速自检清单 ✅

• [ ] 使用 X11
• [ ] 只有一个 compositor
• [ ] 最小配置能跑
• [ ] backend 与功能匹配
• [ ] --debug 无报错

如果你愿意，可以把：

• Debian 版本
• 显卡 / 驱动
• 窗口管理器
• 当前配置

发给我，我可以帮你逐行检查配置。