linux compton配置为何报错

在 Linux 下 compton 配置报错 通常和 配置文件格式、路径、参数变化、或 compositor 被取代 有关。下面按常见原因逐一说明，并给出排查办法。

一、最常见原因汇总

1️⃣ 使用了错误的配置文件格式

compton 早期支持 compton.conf，但新版（以及 picom 分支）使用：

~/.config/compton.conf（旧）
~/.config/picom.conf（新，推荐）

✅ 检查你用的是哪个：

ls ~/.config | grep -E "compton|picom"

如果你装的是 picom，却用了 compton.conf，可能直接报错或忽略。

2️⃣ compton 已被 picom 取代（重要）

现在很多发行版：

compton → 停止维护
picom → 官方继任者

which compton
which picom

如果你运行的是：

compton

但系统只有 picom，会报错或无效。

✅ 建议改为：

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

3️⃣ 配置文件路径不对

compton/picom 不会自动找错路径

正确位置：

~/.config/compton.conf
# 或
~/.config/picom.conf

错误示例：

~/compton.conf
/etc/compton.conf

测试：

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

4️⃣ 配置参数已废弃（非常常见）

例如这些 已失效：

shadow-exclude = ".*"
xrender-sync

新版写法：

shadow-exclude = [
  "name = 'Notification'"
];

✅ 检查报错信息中是否出现：

unknown option
deprecated
parse error

5️⃣ 桌面环境冲突

如果你在用：

GNOME（自带 compositor）
KDE（KWin）
Xfce 已开启合成器

再启动 compton 会冲突或失败。

✅ 关闭系统合成器后再试：

picom --no-startup-id

6️⃣ 显卡 / 驱动问题

常见于：

NVIDIA 闭源驱动
Wayland 环境（compton 只支持 X11）

检查：

echo $XDG_SESSION_TYPE

如果是 wayland → compton 不能用

二、快速排错流程（推荐）

# 1. 看版本
picom --version

# 2. 用默认配置测试
picom --config /dev/null

# 3. 打开调试
picom --config ~/.config/picom.conf --debug

把 完整报错信息 贴出来，我可以精确告诉你哪一行错了。

三、最小可用配置示例（picom）

backend = "glx";
vsync = true;

shadow = true;
shadow-radius = 12;
shadow-opacity = 0.5;

fade = true;
fade-in-step = 0.03;
fade-out-step = 0.03;

unredir-if-possible = true;

如果你愿意，可以把：

发行版
桌面环境
报错全文
配置文件内容

发出来，我可以逐行帮你改 ✅