debian compton配置要注意啥

在 Debian 上配置 Compton（现多被 picom 替代） 做窗口合成器时，有几个常见坑和注意点，下面按「安装 → 配置 → 常见坑」给你梳理一下。

一、先确认你用的是哪个

Compton：老项目，已基本停止维护
Picom：Compton 的活跃分支（推荐）

Debian 里一般直接装：

sudo apt install picom

（老版本仓库可能还叫 compton，但建议用 picom）

二、基本配置文件位置

配置文件一般放：

~/.config/picom/picom.conf

如果没有，可以复制示例：

mkdir -p ~/.config/picom
cp /usr/share/doc/picom/examples/picom.sample.conf ~/.config/picom/picom.conf

三、启动方式（很重要）

1️⃣ 不要重复启动合成器

如果你用的是：

GNOME / KDE → 不要用 compton/picom
XFCE / Openbox / i3 / Awesome → 才适合

2️⃣ 在窗口管理器启动项中加：

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

或（老 compton）：

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

⚠️ 确保 只启动一次

四、Debian 上最常见的问题

✅ 1. 黑屏 / 闪屏

原因：

开启了 glx 后端但不兼容
NVIDIA 驱动问题

建议先试：

backend = "xrender";

稳定后再试：

backend = "glx";

✅ 2. NVIDIA 用户注意

在 picom.conf 中：

vsync = true;
unredir-if-possible = true;

如果花屏，可尝试：

backend = "xrender";

✅ 3. 透明终端不生效

确认：

终端支持透明（alacritty / kitty / urxvt）
picom 已运行
配置中启用：

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

✅ 4. 窗口阴影太重 / 卡顿

调整：

shadow = true;
shadow-radius = 8;
shadow-opacity = 0.3;
shadow-exclude = [
  "name = 'Notification'",
  "class_g = 'Conky'"
];

✅ 5. 全屏掉帧（游戏 / 视频）

开启：

unredir-if-possible = true;

这样全屏程序会绕过合成器。

五、调试技巧

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

或看日志：

picom -b --log-file /tmp/picom.log

六、推荐的最小可用配置（XFCE / i3）

backend = "xrender";
vsync = true;
shadow = true;
shadow-opacity = 0.25;
fade = true;
unredir-if-possible = true;

如果你愿意，可以告诉我：

你用的 桌面环境 / 窗口管理器
是 Intel / AMD / NVIDIA
主要用途（日常 / 游戏 / 录屏）

我可以直接给你一份可用配置。