麒麟系统通过验证驱动、环境和设备判断gpu加速是否就绪，而非暴露抽象接口；需依次确认内核识别、驱动加载、工具链可用及用户态运行时支持。
麒麟系统不直接暴露“硬件加速接口”这个抽象概念，而是通过验证具体驱动、运行时环境和可用设备来判断 GPU 加速能力是否就绪。查不到接口列表，不代表没加速；查到 nvidia-smi 或 radeontop 能跑，才真正说明调用链通了。
确认 GPU 设备是否被内核识别
这是所有后续检测的前提。很多“GPU加速失败”的问题，根源是设备压根没进系统视野。
- 执行
lspci | grep -i vga：必须看到类似01:00.0 VGA compatible controller: NVIDIA Corporation GP104 [GeForce GTX 1080] (rev a1)的输出，否则物理连接或 BIOS 设置（如禁用独显/核显切换）就有问题 - 执行
lshw -c display：看configuration行是否有driver=nouveau或driver=nvidia；若显示driver=fbdev或为空，说明驱动未加载 - 执行
dmesg | grep -i "drm\|nvidia\|radeon\|amdgpu"：重点找[drm] Initialized或NVRM: loading NVIDIA kernel module这类成功初始化日志；如果只有failed to load firmware，大概率是固件缺失（/lib/firmware下缺对应文件）
区分驱动类型并验证对应工具链
麒麟 V10 对不同 GPU 厂商的支持路径完全不同，不能混用命令。NVIDIA、AMD 和 Intel 核显的检测逻辑、依赖包、甚至权限要求都差异极大。
-
NVIDIA 显卡：必须装闭源驱动才能启用 CUDA / OpenGL 加速。验证方式是运行
nvidia-smi—— 若报错NVIDIA-SMI has failed because it couldn't communicate with the NVIDIA driver，说明驱动安装失败或 nouveau 未彻底屏蔽（常见于未在/etc/modprobe.d/blacklist.conf中加blacklist nouveau并更新 initramfs） -
AMD Radeon（尤其是 ARM64 麒麟）：优先走开源
amdgpu驱动。安装radeontop后运行，若提示Failed to open DRM device，说明当前用户不在video用户组里，需执行sudo usermod -aG video $USER并重新登录 -
Intel 核显（常见于 X86 麒麟桌面版）：通常开箱即用，但要验证 VA-API 硬解能力，得装
intel-gpu-tools，再运行intel_gpu_top；若报Permission denied，不是权限问题，而是内核参数没开 —— 检查cat /proc/cmdline是否含i915.enable_guc=2（SP3 及以后推荐）
检查用户态运行时是否可用
驱动加载 ≠ 应用能调用。很多国产中间件或容器应用依赖特定运行时，比如 Docker GPU 容器需要 nvidia-container-toolkit，而普通桌面应用可能卡在 OpenGL 上下文创建失败。
- 验证 OpenGL：运行
glxinfo | grep "OpenGL renderer"，输出应为显卡型号而非llvmpipe（软件渲染）；若为后者，说明 Mesa 驱动未正确绑定硬件 - 验证 Vulkan：运行
vulkaninfo --summary，看GPU0下的deviceName是否真实，且apiVersion不为 0；若报ERROR: [Loader Message] Code 0 : loader_scanned_icd_add: Could not get 'vk_icdGetInstanceProcAddr'...，说明 Vulkan ICD JSON 文件未注册到/usr/share/vulkan/icd.d/ - Docker 场景下：运行
docker run --rm --gpus all nvidia/cuda:11.0-base-ubuntu20.04 nvidia-smi，失败常见原因是nvidia-docker2包未装，或/etc/docker/daemon.json里漏配"runtimes": {"nvidia": {...}}
真正卡住人的，往往不是命令不会敲，而是把“驱动装了”等同于“加速可用”。比如 nvidia-smi 能跑，但 glxinfo 还是 llvmpipe —— 这说明 NVIDIA 驱动只提供了 CUDA 支持，没接管图形栈；又比如 vulkaninfo 成功，但 Qt 应用仍软解视频 —— 很可能是应用自己没启用 Vulkan 渲染后端。每个环节都得单独过一遍，少一个都不算通。
