错误现象
CUDA 程序启动时提示驱动版本不足、runtime mismatch 或无法初始化 GPU。
典型报错
TODO：粘贴完整错误和 nvidia-smi 输出。
可能原因
- NVIDIA 驱动版本低于目标 CUDA runtime 要求。
- 多个 CUDA 路径混用。
- 容器内外 CUDA 运行时不一致。
排查命令
TODO：记录 nvidia-smi、nvcc --version、echo $LD_LIBRARY_PATH。
解决步骤
先确认驱动支持范围，再调整 Toolkit、Conda 包或容器镜像版本。
验证方法
目标软件可识别 GPU，并通过最小测试。
相关服务入口
参见 /services/gpu-cuda-env。