linux compton配置错误怎查

在 Linux 下 compton（或已改名为 picom）配置错误 通常有几种排查方式，下面按「从快到细」给你一套常用方法。

一、先看能不能正常启动（最重要）

不要直接依赖自动启动，先手动跑：

compton --config ~/.config/compton.conf

或（picom）：

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

常见现象

• 直接退出 → 配置语法错误
• 黑屏 / 闪退 → backend 或 shadow 设置问题
• 无效果 → 被其他合成器占用

二、开启调试输出（非常有用）

compton --config ~/.config/compton.conf -b -d

或：

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

重点看：

• error
• parse
• unknown option
• backend

三、检查配置语法（最常见错误）

compton / picom 不支持 YAML 缩进错误

错误示例 ❌

shadow {
  enabled = true
}

正确示例 ✅

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

✅ 每条配置 以分号结尾 ✅ 不要用大括号（那是旧版实验语法）

四、确认 backend 是否正确

某些显卡不支持 glx：

backend = "xrender";

如果用了：

backend = "glx";

但驱动不对 → 直接崩

五、确认没有其他合成器冲突

常见冲突：

• xfwm4 自带合成
• kwin
• mutter
• xcompmgr

检查：

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

只保留一个合成器。

六、最小化配置测试（排错神器）

新建：

nano ~/.config/compton-min.conf

内容：

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

运行：

compton --config ~/.config/compton-min.conf

✅ 如果这样可以 → 你原配置某一项有问题

七、常见错误速查表

八、你如果愿意，可以直接贴配置

把下面内容发我：

1. 发行版（如 Arch / Ubuntu）
2. 桌面环境（XFCE / i3 / KDE）
3. compton.conf 或 picom.conf
4. 报错信息（终端输出）

我可以直接帮你 逐行改到能用 ✅