在 Debian 上用 Compton（或其继任者 Picom） 做 compositor（合成器）时，确实有不少“常见坑”。下面按现象 → 原因 → 解决办法整理，偏实战。
Compton 需要后端：
xrender（老，兼容好）glx（需要 OpenGL）egl（较新）坑：
在虚拟机 / 老旧显卡 / 没有 3D 加速的环境用 glx 会直接崩。
✅ 解决：
backend = "xrender";
或命令行：
compton --backend xrender
比如：
坑：
两个 compositor 冲突，画面闪、卡、甚至黑屏。
✅ 解决：
现象：
坑：
Compton 默认对所有窗口生效。
✅ 解决：加规则
opacity-rule = [
"100:class_g = 'Firefox'",
"95:class_g = 'Alacritty'"
];
shadow-exclude = [
"class_g = 'Firefox'",
"class_g = 'mpv'"
];
或者全屏不合成：
unredir-if-possible = true;
现象：
✅ 调整参数：
shadow = true;
shadow-radius = 4;
shadow-offset-x = -2;
shadow-offset-y = -2;
shadow-opacity = 0.4;
Debian stable 里的 compton 往往：
✅ 建议：
sudo apt install picom
坑：
glx + 高 DPI✅ 优化：
vsync = true;
mark-wmwin-focused = true;
mark-ovredir-focused = true;
坑：
force-win-blend 问题✅ 解决：
backend = "glx";
glx-no-stencil = true;
或换 xrender
现象：
✅ 解决：
xrender坑：
.xinitrc 里写错✅ 正确示例（i3）：
exec --no-startup-id picom
或：
picom &
老 compton：
~/.config/compton.conf
picom：
~/.config/picom.conf
⚠️ 用错文件 = 配置全无效
✅ Debian + 轻量 WM 推荐组合
xrender（稳定）如果你愿意，我可以：
