debian compton配置出错咋办

在 Debian 上 Compton（现多称为 picom）配置出错，一般可以按下面步骤排查和解决。

一、先确认你用的是哪个“compton”

Debian 里常见情况：

• 老包名：compton
• 新包名：picom（compton 的活跃分支）

建议直接用 picom：

sudo apt update
sudo apt install picom

运行：

picom

或

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

二、最常见错误及解决办法

1️⃣ 配置文件路径不对

picom 默认读取：

~/.config/picom/picom.conf

（不是 compton.conf）

如果文件不存在：

mkdir -p ~/.config/picom
cp /usr/share/doc/picom/examples/picom.conf.example ~/.config/picom/picom.conf

2️⃣ 配置文件语法错误

compton 旧配置和 picom 不兼容，常见错误：

• 使用了旧参数（如 shadow-exclude 格式）
• 少了括号或逗号

检查语法：

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

3️⃣ backend 设置错误

picom.conf 中：

backend = "glx";

如果显卡驱动不支持，会直接退出。

可改成：

backend = "xrender";

4️⃣ 和桌面环境冲突

如果你在用：

• GNOME（默认有合成器）
• KDE
• XFCE 已开启合成

必须先关掉系统合成器，否则 compton/picom 会失败。

XFCE：

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

5️⃣ 没有使用 X11（Wayland 不支持）

Compton / picom 只支持 X11

检查：

echo $XDG_SESSION_TYPE

如果是 wayland，请登出并选择 X11 会话。

三、看错误日志（非常重要）

运行：

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

或前台运行：

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

把报错贴出来，例如：

• failed to create backend
• config error
• another compositor is running

四、最小可用配置（测试用）

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

五、如果你愿意

你可以直接把：

• Debian 版本（cat /etc/os-release）
• 桌面环境
• 报错信息
• 你的配置文件

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