debian compton配置有哪些坑

在 Debian 上配置 Compton（现已多被 picom 取代） 做 compositor（窗口透明、阴影、动画等）时，确实有不少“坑”。下面按常见失败点 + 解决方案给你梳理一下。

一、Compton 本身的问题（版本坑）

1. Debian 仓库里的 compton 已过时

• Debian 旧版本：compton
• 新版本项目已改名：picom

✅ 建议：

sudo apt install picom

然后配置 ~/.config/picom.conf

❌ 不要继续用老 compton，很多 feature 已废

二、桌面环境冲突（最大坑）

2. 和桌面自带 compositor 冲突

如果你用的是：

• GNOME（mutter）
• KDE（kwin）
• XFCE（自带 compositor）

⚠️ 会：

• 黑屏
• 闪屏
• 透明失效

✅ 解决方法：

# XFCE
设置 → 窗口管理器微调 → 关闭 compositor

# KDE
系统设置 → 显示与监控 → 关闭合成器

三、显示协议坑（X11 / Wayland）

3. Wayland 下 Compton 完全不可用

Compton / picom 只支持 X11

检查：

echo $XDG_SESSION_TYPE

如果是 wayland：

• GNOME → 登录时选 “GNOME on Xorg”
• 否则直接换窗口管理器（i3 / bspwm / openbox）

四、配置文件坑（最容易踩）

4. 配置文件位置不对

正确路径：

~/.config/picom.conf

旧 compton 可能是：

~/.config/compton.conf

⚠️ 用 picom 但写 compton.conf 不会生效

5. 配置文件语法错误直接崩溃

picom 对语法极敏感：

❌ 错误示例：

shadow = true;

✅ 正确：

shadow = true;

（注意不是逗号、不是 tab）

建议从官方示例开始：

cp /usr/share/doc/picom/examples/picom.sample.conf ~/.config/picom.conf

五、启动方式坑

6. 启动太早导致黑屏

常见于：

• i3
• bspwm
• lightdm 自动启动

✅ 正确方式（i3 示例）：

exec --no-startup-id picom

❌ 不要放 /etc/rc.local

7. NVIDIA 显卡特殊坑

常见问题：

• 透明窗口黑块
• 撕裂

✅ 推荐配置：

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

并确认：

nvidia-settings → OpenGL → Allow Flipping

六、透明 / 阴影不生效

8. 应用本身不支持透明

• 终端：要开 transparency
• 某些 Qt 程序无效

可强制：

opacity-rule = [
  "90:class_g = 'URxvt'",
  "80:class_g = 'Firefox'"
];

七、性能 / CPU 占用高

9. 动画 / 模糊导致卡顿

关掉：

blur-method = "none";
animations = false;

八、日志调试（非常重要）

启动调试：

picom --diagnostics
picom -b --log-level trace

常见报错：

• Another composite manager running
• Failed to load backend

总结常见坑位清单 ✅

如果你愿意，可以告诉我：

• Debian 版本
• 桌面 / WM
• 显卡

我可以直接给你一份可用 picom.conf。