linux compton怎么排查错误

linux

小樊

2026-09-03 16:45:13

栏目: 智能运维

在 Linux 上排查 compton（或已改名为 picom） 的错误，一般按下面步骤来，从「能不能跑」到「为什么不对」逐步定位。

一、确认你在用哪个程序

先搞清楚是 compton 还是 picom：

which compton
which picom
compton --version
picom --version

很多发行版里 compton 已经是旧名，picom 是维护版。

二、前台运行看错误输出（最重要）

不要直接放后台，先手动跑：

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

观察终端输出，常见错误：

配置文件语法错误
backend 不支持（glx / xrender）
显示器/窗口管理器不兼容

三、开启调试日志

compton

compton -b=false --log-level debug

picom

picom --log-level debug

或写配置：

log-level = "debug";

四、检查配置文件

常见错误点：

路径不对

ls ~/.config/compton.conf
ls ~/.config/picom.conf

语法错误
- 分号 ; 结尾
- 括号匹配
- 不支持的选项

可用：

picom --config ~/.config/picom.conf --dry-run

五、确认窗口管理器 / 会话

compton 只支持 X11，不支持纯 Wayland。

echo $XDG_SESSION_TYPE

如果是 wayland：

GNOME / KDE Wayland → 不需要 compton
想用 compositor → 用 wayfire / hyprland / sway

六、常见具体问题排查

1. 透明无效

窗口管理器是否支持 _NET_WM_WINDOW_OPACITY

检查：

opacity-rule = [ "80:class_g = 'URxvt'" ];

2. 黑屏 / 卡死

尝试换 backend：

backend = "xrender";

或

backend = "glx";

3. 启动但没效果

确认没有其他 compositor：

ps aux | grep -E "compton|picom|xfwm4|mutter|kwin"

七、查看系统日志

journalctl -xe | grep -i compton
dmesg | grep -i gpu

八、最小可用配置（测试用）

backend = "xrender";
opacity-rule = [ "90:class_g = '.*'" ];
shadow = false;
fade = false;

如果你愿意，可以把：

发行版
窗口管理器
报错原文
配置文件

发出来，我可以直接帮你改。