debian compton常见错误有哪些

在 Debian 上使用 Compton（现为 Picom 前身） 作为复合管理器时，常见错误和坑主要集中在依赖、配置、显卡驱动、会话管理几个方面。下面按“现象 → 原因 → 解决办法”整理常见错误。

一、Compton 无法启动 / 启动后立刻退出

1. 缺少依赖库

现象

compton: error while loading shared libraries: libxxx.so.x: cannot open shared object file

原因

• Debian 最小化安装时常缺少 X11 / GL 相关库

解决

sudo apt install libxext6 libxrender1 libgl1 libdbus-1-3

2. 没有运行在 X11 会话

现象

Cannot open display

原因

• 使用了 Wayland（GNOME/Wayland）
• Compton 只支持 X11

解决

• 登录时选择 “X11” / “on Xorg”
• 或改用 picom（仍限于 X11）

二、黑屏 / 闪屏 / 窗口消失

3. 与窗口管理器冲突

现象

• 启动 compton 后窗口全黑
• 或桌面环境卡死

原因

• 同时启用了：
  • GNOME 自带 compositor
  • KWin / Mutter
  • 另一个 picom/compton

解决

# 先杀掉已有复合器
killall compton picom

• 在 GNOME 中关闭：

gsettings set org.gnome.mutter compositor true

（或干脆用轻量 WM：i3 / Openbox）

4. backend = “glx” 导致黑屏

现象

• 启动即黑屏
• 日志中有 GLX 错误

原因

• 显卡驱动不完整（尤其是 NVIDIA 闭源驱动）

解决 编辑 ~/.config/compton.conf：

backend = "xrender";

或升级驱动：

sudo apt install nvidia-driver

三、透明 / 阴影异常

5. 透明无效

现象

• 终端不透明
• 阴影不显示

原因

• 应用不支持 ARGB
• 配置未开启

解决

opacity-rule = [
  "90:class_g = 'URxvt'",
  "95:class_g = 'Alacritty'"
];

并确保：

shadow = true;

6. 阴影过重 / 卡顿

现象

• 系统变慢
• 阴影拖影

解决

shadow-radius = 4;
shadow-opacity = 0.3;
shadow-exclude = [ "name = 'Notification'" ];

四、开机自启问题

7. 登录后 compton 未启动

原因

• 没有加入 autostart
• 启动顺序错误

解决（i3 示例）

echo "exec --no-startup-id compton" >> ~/.config/i3/config

Openbox

<application name="compton" class="Compton">
  <command>compton</command>
</application>

五、Debian 特有注意事项

8. compton 已被弃用

Debian 新版本更推荐：

sudo apt install picom

命令改为：

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

9. 日志调试方式

compton --diagnostics
compton -b --log-level trace

六、最常见错误速查表

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

• Debian 版本（11 / 12）
• 桌面环境（GNOME / i3 / Openbox）
• 显卡型号

我可以给你一份可直接用的 compton / picom 配置。