linux xrender为何黑屏

在 Linux 下使用 XRender 出现黑屏，通常不是 XRender 本身“坏掉”，而是渲染路径、合成器、驱动或用法出了问题。下面按常见原因 → 现象 → 解决办法来说明。

一、最常见原因

1️⃣ 没有启用 Composite（合成）扩展

XRender 很多效果依赖 Composite + 红raw。

现象

窗口透明变黑
整个屏幕或窗口黑屏
只在 XRender 模式下出问题

解决

xcompmgr &
# 或
picom &

确认：

xdpyinfo | grep Composite

2️⃣ 显卡驱动问题（尤其是 NVIDIA / 老 Intel）

XRender 对驱动实现非常敏感。

常见情况

NVIDIA 闭源驱动 + XRender → 黑屏
虚拟机（QEMU / VMware）未开启 3D
老显卡只支持部分 XRender

解决

更新驱动
尝试：
- modesetting
- intel
- NVIDIA → 尝试 nvidia + AllowIndirectGLX
虚拟机开启 3D 加速

3️⃣ 应用程序错误地使用 XRender

典型错误：

创建了 Picture 但没填内容
alpha = 0
用 XRenderComposite 但源/目标不匹配

现象

只有该 App 黑屏
其他程序正常

示例错误

XRenderComposite(dpy, PictOpOver, src, 0, dst, 0,0,0,0,0,0, w,h);

但 src 是空的。

4️⃣ 透明窗口 + 无背景

XRender 透明 ≠ 自动有背景

现象

窗口黑（其实是“透明到根窗口”）
拖动窗口才显示

解决

XSetWindowAttributes attr;
attr.background_pixel = WhitePixel(dpy, screen);

或使用：

XRenderFillRectangle(...)

5️⃣ Wayland 下误用 XRender

Wayland 不支持 XRender
某些 XWayland 下会黑屏

解决

切回 X11
或用 OpenGL / Vulkan

6️⃣ 色深 / Visual 不匹配

32bit ARGB vs 24bit
XRender Picture 格式错误

检查

xdpyinfo | grep "depth"

二、快速排查清单 ✅

# 1. 是否 X11
echo $XDG_SESSION_TYPE

# 2. Composite 是否开
xdpyinfo | grep Composite

# 3. 合成器是否在跑
ps aux | grep -E "picom|xcompmgr|compton"

# 4. 驱动
glxinfo | grep "Renderer"

三、如果你能补充信息，我可以精准定位

请告诉我：

发行版（Ubuntu / Arch / CentOS？）
显卡 & 驱动
黑屏场景（整个桌面 / 某个程序 / 透明窗口）
是否用 Wayland
是写代码还是用现成软件（Chrome / Qt / GTK？）

我可以直接告诉你是哪一行配置或代码导致黑屏。