1. 课程导入

Linux 图形栈是一条从内核到应用、从硬件到窗口系统的长链路。一次“黑屏”“花屏”“卡顿”“外接显示器不亮”或“Wayland 会话无法启动”，其根因可能位于 DRM/KMS 驱动、GEM/TTM 显存管理、Mesa 用户态驱动、EGL/GL/Vulkan 接口、合成器、显示管理器，甚至只是权限或环境变量配置错误。本课程的目标，是把这条链路拆解成可观测、可验证、可定位的工程对象，让故障诊断从“凭经验重启”升级为“按证据推理”。

学习目标：从现象到根因的工程能力

完成本课程后，学习者应具备四类能力：第一，能画出目标系统的图形栈拓扑，明确每一层由哪个进程、哪个库、哪个内核模块承担；第二，能使用标准工具采集关键证据，例如内核日志、DRM 状态、GPU 寄存器信息、Mesa 调试输出、合成器日志与性能计数器；第三，能根据“现象—信号—模块”的映射关系缩小故障域；第四，能给出可复现的修复方案，并通过回归验证确认问题真正关闭，而不是被临时规避。

核心概念：图形栈的分层与关键对象

Linux 图形栈可以按“硬件—内核—用户态—会话—应用”五段理解。硬件层包括 GPU、显示控制器、连接器（HDMI/DP/eDP）、面板与背光。内核层以 DRM（Direct Rendering Manager）和 KMS（Kernel Mode Setting）为核心，负责显示模式设置、帧缓冲管理、显存对象（GEM/TTM）与命令提交；GPU 驱动通常以 i915、amdgpu、nouveau、msm 等模块形式存在。用户态层由 Mesa 提供 OpenGL/Vulkan/EGL 实现，配合 libdrm、libglvnd、Vulkan loader 等库。会话层包括 X.Org、Wayland 合成器（如 GNOME Shell、KWin、Sway）与显示管理器（GDM、SDDM、LightDM）。应用层则是浏览器、游戏、视频播放器与桌面程序。

诊断中必须区分几个容易混淆的概念：DRM 设备节点（/dev/dri/card0、renderD128）代表内核暴露的渲染与显示能力；KMS 负责“显示什么、怎么显示”；GEM/TTM 负责显存对象的分配与迁移；EGL/GL/Vulkan 是应用与 GPU 之间的编程接口；合成器决定窗口如何被合成并提交给 KMS。很多“应用崩溃”其实是合成器或驱动层问题的下游表现。

方法流程：证据驱动的诊断闭环

建议采用“五步闭环”。第一步，界定现象：是启动阶段黑屏、登录后花屏、运行中卡顿，还是外接显示异常；记录发生时机、可复现性与最近变更。第二步，建立拓扑：确认会话类型（X11/Wayland）、GPU 型号、驱动模块、Mesa 版本与合成器。第三步，采集证据：按层抓取日志与状态，避免只盯一个文件。第四步，缩小故障域：用替换法与对照法验证假设，例如切换合成器、切换渲染后端、使用软件渲染对比。第五步，修复与回归：记录修复参数或补丁，并在相同场景下复测。

# 常用证据采集入口（示例）
dmesg | grep -Ei 'drm|i915|amdgpu|nouveau|kms|edid'
ls -l /dev/dri/
cat /sys/class/drm/card0-*/status
modetest -M i915 -c            # 查看连接器与模式
glxinfo -B                     # OpenGL 渲染器与版本
vulkaninfo --summary           # Vulkan 设备与驱动
journalctl -b -u gdm -u sddm   # 会话/显示管理器日志

典型应用场景与误区复盘

典型场景包括：服务器远程桌面图形加速异常、笔记本外接 4K 显示器无法点亮、游戏在 Wayland 下崩溃、虚拟机 GPU 直通后花屏、以及内核升级后 DRM 驱动回归。不同场景的优先观测点不同：外接显示问题优先看连接器状态与 EDID；渲染崩溃优先看 Mesa 与 Vulkan 层；启动黑屏优先看 KMS 与显示管理器。

本课程后续将围绕这条分层链路展开：先建立可观测性，再逐层深入 DRM/KMS、Mesa、合成器与性能分析，最终形成一套可复用的图形栈故障诊断工程方法。