linux compton怎么调试

在 Linux 下调试 compton（或它的继任者 picom）通常是为了解决：

透明/阴影异常
闪屏、卡顿
窗口显示错误
启动失败

下面从基础调试 → 日志 → 常见坑逐步说明。

一、先用正确的命令启动（非常重要）

1. 前台运行（看日志）

compton --config ~/.config/compton.conf

或（推荐，picom 是 compton 的维护分支）：

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

如果直接崩溃，会立刻看到报错。

2. 开启调试日志

compton -b --log-level debug --log-file /tmp/compton.log

或

picom --log-level debug --log-file /tmp/picom.log

然后：

tail -f /tmp/compton.log

二、常见调试参数

参数	作用
`--no-fading`	关闭淡入淡出
`--no-shadow`	关闭阴影
`--backend xrender`	用 xrender（兼容性最好）
`--backend glx`	用 OpenGL（更快但易出问题）
`--vsync`	尝试不同 vsync 模式
`-D`	设置 fade 时间（调试动画）

示例：

compton --backend xrender --no-shadow --no-fading

三、最小配置法（定位问题）

新建一个最小配置：

~/.config/compton.conf

backend = "xrender";
shadow = false;
fade = false;

然后启动：

compton --config ~/.config/compton.conf

✅ 如果没问题 → 逐步开启功能
❌ 如果还有问题 → 不是配置问题，是环境/驱动

四、检查运行环境

1. 确认窗口管理器

compton 不能和自带合成器的共存：

GNOME（mutter）
KDE（kwin）
Xfce（自带 compositor）

解决：

xfwm4 --compositor=off

或在设置里关掉合成器

2. 确认是 X11 而不是 Wayland

echo $XDG_SESSION_TYPE

必须是：

x11

Wayland 下 compton 不可用

五、GPU / 驱动问题（最常见）

NVIDIA

backend = "glx";
glx-no-stencil = true;

或者退回到：

backend = "xrender";

Intel / AMD

一般 xrender 最稳

六、常见故障速查表

现象	可能原因
启动直接退出	配置语法错误
全屏黑 / 闪烁	backend 不对
窗口边框透明	shadow 配置错误
视频卡顿	vsync 问题
登录后无效果	被 WM 合成器覆盖

七、推荐：改用 picom（compton 已停更）

sudo apt install picom

或

yay -S picom

picom 调试方式完全一致，但：

bug 更少
支持更多特效
日志更清晰

如果你愿意，可以把：

你的 发行版
窗口管理器
compton/picom 版本
报错日志

贴出来，我可以帮你精准定位问题。