在 Debian 上使用 Compton(或已演进为 Picom) 时,出现黑屏是比较常见的问题,通常与显卡驱动、合成器配置、窗口管理器或显示器设置有关。下面按常见原因 → 解决方案说明。
Debian 新版中:
compton 已停止维护picom)建议直接使用:
sudo apt install picom
现象:启动 compton/picom 后整个屏幕变黑。
解决:改用 xrender 后端
编辑配置文件(如 ~/.config/picom.conf):
backend = "xrender";
或命令行测试:
picom --backend xrender
✅ 如果这样不黑屏,就说明是 OpenGL 问题。
现象:
解决 A:使用闭源驱动
sudo apt install nvidia-driver
reboot
解决 B:禁用某些 GL 特性
backend = "xrender";
vsync = false;
glx-no-stencil = true;
Compton 只是合成器,不是窗口管理器。
如果你只运行了:
compton
而没有:
openbox
# 或 i3 / bspwm / dwm
就会黑屏。
✅ 正确方式:
openbox &
picom &
现象:副屏黑,或主屏黑
解决:明确指定显示器
refresh-rate = 60;
或临时关闭多屏测试:
xrandr --output HDMI-1 --off
现象:启动瞬间黑屏,然后退出
解决:使用最小配置测试
~/.config/picom.conf
backend = "xrender";
vsync = false;
启动:
picom --config ~/.config/picom.conf
查看错误原因:
picom --log-level TRACE
或:
journalctl -xe
backend = "xrender";
vsync = false;
shadow = true;
fade = true;
请提供以下信息,我可以进一步精确定位:
cat /etc/os-release)lspci | grep VGA)✅ 一句话总结:
Debian 下 Compton/Picom 黑屏,90% 是 backend=OpenGL + NVIDIA/驱动问题,改用
xrender基本都能解决。
如果你愿意,我也可以帮你写一份完整可用的 Debian + i3 + picom 配置。