linux compton配置为何失败

在 Linux 下 compton（现为 picom）配置失败 的原因很多，下面按常见原因 → 排查方法 → 解决示例来说明，你可以对照自己的情况。

一、最常见原因

1️⃣ 配置文件路径不对

compton 默认读取：

~/.config/compton.conf

或旧版本：

~/.compton.conf

❌ 错误示例：

~/.config/compton/compton.conf   # 错

✅ 正确：

~/.config/compton.conf

2️⃣ 配置文件语法错误

compton 使用 INI 风格，不是 YAML / JSON。

❌ 错误：

shadow: true
blur:
  method = gaussian

✅ 正确：

shadow = true
blur-method = gaussian

3️⃣ 用了 compton，但系统已是 picom

很多发行版已弃用 compton：

compton → picom

检查：

which compton
which picom

✅ 建议直接使用：

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

4️⃣ 没有窗口管理器 / 会话不支持

compton 需要：

• X11（不是纯 Wayland）
• 已在运行 WM（i3 / bspwm / openbox 等）

检查：

echo $XDG_SESSION_TYPE

如果是 wayland，compton 不工作

5️⃣ 同时启动了多个合成器

例如：

• xcompmgr
• picom
• compton
• kwin 自带合成

冲突会导致“看起来没生效”。

解决：

pkill compton
pkill picom
pkill xcompmgr

二、调试方法（非常重要）

✅ 前台运行看报错

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

或

picom -b --config ~/.config/compton.conf --log-level info

常见错误：

• Invalid option
• Parse error
• Backend not supported

三、一个最小可用配置示例

backend = "glx"
vsync = true
shadow = true
shadow-radius = 12
shadow-opacity = 0.4
fade = true
fade-in-step = 0.03
fade-out-step = 0.03

启动：

picom --config ~/.config/compton.conf &

四、如果你愿意，我可以精准帮你

你可以直接贴出：

1. 发行版（Arch / Ubuntu / Debian？）
2. 桌面环境 / 窗口管理器
3. 你的 compton 配置文件
4. 启动命令 & 报错信息

我可以一行一行帮你改 ✅