Compton 是 Linux 下常用的 compositor(窗口合成器),常用于 i3、Openbox 等轻量桌面。报错原因很多,下面按常见报错 → 排查思路 → 解决方案给你一个通用排查手册。
先运行:
compton
或
compton --diagnostics
把完整报错信息复制出来(比如 Failed to load backend、GLX error 等)。
报错类似:
compton: Cannot read configuration file
✅ 解决:
touch ~/.config/compton.conf
或创建:
mkdir -p ~/.config
nano ~/.config/compton.conf
最小配置示例:
backend = "glx";
glx-no-stencil = true;
shadow = false;
报错:
GLX error / failed to initialize backend
✅ 解决方式:
方案 A:改用 xrender
backend = "xrender";
方案 B:禁用 GLX 特性
backend = "glx";
glx-no-stencil = true;
glx-no-rebind-pixmap = true;
方案 C:虚拟机 / 老显卡
xrender报错:
Another compositor is already running
✅ 解决:
killall compton
killall picom
或检查:
ps aux | grep compton
Compton 只支持 X11。
✅ 检查:
echo $XDG_SESSION_TYPE
如果是 wayland:
picom(仍仅 X11)command not found: compton
✅ 安装:
# Debian / Ubuntu
sudo apt install compton
# Arch
sudo pacman -S compton
# Fedora
sudo dnf install compton
⚠️ 注意:很多发行版已用 picom 替代 compton
sudo apt install picom
picom &
如果你只是想要透明 + 阴影,直接用 picom:
picom --backend xrender &
请把下面信息发我:
我可以直接帮你写一份能跑的配置文件 ✅