Compton为何启动失败

Compton（现代常见分支为 picom）启动失败的原因很多，常见有以下几类。你可以对照排查：

一、显卡 / 驱动问题（最常见）

1. 没有正确显卡驱动

• NVIDIA 用户：
  • 未安装闭源驱动，或驱动版本不兼容
  • 使用 Wayland 却强行跑 Compton（Compton 只支持 X11）
• AMD / Intel：
  • 缺少 mesa、xf86-video-amdgpu 等驱动

✅ 检查：

lspci -k | grep -A2 VGA
glxinfo | grep "OpenGL renderer"

二、X11 会话问题

1. 在 Wayland 下运行

Compton / picom 只能在 X11 下运行。

✅ 检查当前会话：

echo $XDG_SESSION_TYPE

如果是 wayland，启动会直接失败。

三、已有合成器冲突

常见冲突对象

• xfwm4 --compositor
• mutter
• kwin
• xcompmgr
• 其他 picom 实例

✅ 检查：

ps aux | grep compton
ps aux | grep picom

✅ 关闭已有合成器：

killall picom
killall compton

四、配置文件错误

1. 配置语法错误

• 旧版 compton 和新版 picom 配置不兼容
• 使用了错误的参数

✅ 测试默认配置：

picom --no-fading-openclose --no-fading-destroy

✅ 临时忽略配置：

picom --config /dev/null

五、缺少依赖或库

常见缺失

• libconfig
• libev
• pixman
• xcb-* 系列库

✅ Debian / Ubuntu：

sudo apt install libconfig-dev libev-dev libpixman-1-dev xcb-proto

✅ Arch：

sudo pacman -S picom

六、无显示器 / DISPLAY 未设置

1. SSH / 无头环境

Compton 需要 X server。

✅ 检查：

echo $DISPLAY

七、日志查看（最关键）

启动失败时看日志

picom --log-level trace

或：

compton -b 2> ~/compton.log

常见错误示例：

• No X visual found
• Failed to load backend
• Another composite manager is already running

八、Compton 已停止维护

⚠️ Compton 已停止开发，推荐：

picom

• 更现代
• 更好的 XRender / GLX / Vulkan 支持
• 配置更清晰

快速自检清单 ✅

• [ ] 使用 X11 而不是 Wayland
• [ ] 显卡驱动正常
• [ ] 没有其他合成器
• [ ] 配置文件无错误
• [ ] 有 $DISPLAY
• [ ] 使用 picom 而非旧 compton

如果你愿意，可以把 启动报错信息 或 系统环境（发行版 / 显卡 / X11 or Wayland）发出来，我可以直接帮你精准定位。