如何修复debian compton报错

在 Debian 上 compton（现在更常以 picom 形式存在）报错，常见原因包括：缺少依赖、配置文件错误、与桌面环境/显示管理器冲突、以及 X11/Wayland 不兼容。下面按「排查 → 常见报错 → 修复方法」给你一个系统性的解决思路。

一、先做基础排查

1. 确认你用的是 compton 还是 picom

Debian 新版中：

• compton 已停止维护
• 官方推荐是 picom

which compton
which picom

如果只有 picom，请用：

picom

2. 查看具体报错

不要直接后台运行，先看输出：

compton
# 或
picom

或查看日志：

picom --log-level DEBUG

把报错信息复制出来，是定位问题的关键。

二、常见报错及修复

❶ 缺少依赖（最常见）

报错示例：

error while loading shared libraries: libxxx.so

修复：

sudo apt update
sudo apt install -y \
  libxext-dev libxcb1-dev libxcb-damage0-dev \
  libxcb-composite0-dev libxcb-randr0-dev \
  libxcb-image0-dev libxcb-util-dev \
  libxcb-glx0-dev libpixman-1-dev \
  libconfig-dev libdbus-1-dev

如果你是从源码编译的，更需要这些。

❷ 配置文件错误

报错示例：

parse error in config file

修复：

• 使用默认配置测试：

mv ~/.config/compton.conf ~/.config/compton.conf.bak
compton

• 或改用 picom 默认：

picom --config /dev/null

如果这样能跑，说明是配置文件问题。

❸ already running（端口/实例冲突）

报错：

Another composite manager is already running

解决：

killall compton
killall picom

或查看：

ps aux | grep compton

❹ 在 Wayland 下运行（不支持）

compton/picom 只支持 X11。

检查：

echo $XDG_SESSION_TYPE

如果是 wayland：

• 注销
• 登录时选择 GNOME on Xorg / X11

❺ 与桌面环境自带的合成器冲突

如：

• GNOME（mutter）
• KDE（kwin）
• XFCE（自带 compositor）

解决（XFCE 示例）：

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

❻ Debian 上推荐直接用 picom（避免旧 bug）

sudo apt remove compton
sudo apt install picom

运行：

picom --daemon

三、推荐的最小可用配置（picom.conf）

~/.config/picom.conf

backend = "glx";
vsync = true;
opacity-rule = [
  "90:class_g = 'Firefox'"
];

测试：

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

四、如果你愿意，我可以进一步帮你

你可以直接贴出：

• 具体报错信息
• cat ~/.config/compton.conf
• echo $XDG_SESSION_TYPE
• Debian 版本（cat /etc/os-release）

我可以帮你精准定位并给出一行修复命令。