VSCode中CUDA C++调试配置与CTRL-F5运行行为差异及驱动兼容问题

我的VSCode中launch.json配置如下：

{
    "name": "CUDA C++ Debug",
    "type": "cuda-gdb",
    "request": "launch",
    "program": "${workspaceFolder}/build/support_01",
    "stopAtEntry": false,
    "cwd": "${workspaceFolder}/build/",
    "preLaunchTask": "CMake: clean rebuild"            
}

调试执行到代码行cudaError_t err = cudaMalloc((void**)&d_list, flattened_list_size);时，出现错误：

Incompatible CUDA driver version. Expected 12.2.134 or later and found 8.0.129 instead."fatal: Incompatible CUDA driver version. (error code = CUDBG_ERROR_INCOMPATIBLE_API(0x13)

但直接按Ctrl+F5运行程序时一切正常，运行日志如下：

[Detaching after fork from child process 69973]
[New Thread 0x7ffff389c000 (LWP 69974)]
[New Thread 0x7ffff07ff000 (LWP 69975)]
[New Thread 0x7fffefffe000 (LWP 69976)]
Loaded '/lib/x86_64-linux-gnu/libcuda.so.1'. Symbols loaded.
Loaded '/lib/x86_64-linux-gnu/libdl.so.2'. Symbols loaded.
Loaded '/lib/x86_64-linux-gnu/libpthread.so.0'. Symbols loaded.
Loaded '/lib/x86_64-linux-gnu/librt.so.1'. Symbols loaded.

解决方案 #

1. 对齐cuda-gdb与系统CUDA驱动版本 #

cuda-gdb对驱动版本的兼容性要求比普通运行更严格——程序直接运行时依赖CUDA Runtime的向前兼容，但调试工具cuda-gdb需要和驱动版本严格匹配或在官方兼容范围内：

• 查看当前cuda-gdb版本：

  cuda-gdb --version
  

• 查看系统CUDA驱动版本：

  nvidia-smi
  

如果cuda-gdb版本过高（如12.2）而驱动版本过低（如8.0），要么降级cuda-gdb到与驱动匹配的版本，要么升级系统CUDA驱动到满足cuda-gdb要求的版本。

2. 统一调试与运行的环境变量 #

直接运行和调试时的环境变量可能不一致，导致调试时加载了错误版本的CUDA工具链：
在launch.json中添加环境变量配置，指定与运行时一致的CUDA路径：

"env": {
    "PATH": "/usr/local/cuda-8.0/bin:${env:PATH}",
    "LD_LIBRARY_PATH": "/usr/local/cuda-8.0/lib64:${env:LD_LIBRARY_PATH}"
}

替换为你实际安装的CUDA版本路径，确保调试时使用的CUDA库和运行时一致。

3. 指定CMake编译的CUDA版本 #

检查CMakeLists.txt，确保编译程序时使用的CUDA版本与系统驱动、调试工具兼容：

find_package(CUDA 8.0 REQUIRED)

4. 强制指定cuda-gdb路径 #

若系统中存在多版本cuda-gdb，VSCode调试可能误调用高版本工具，可在launch.json中直接指定匹配版本的绝对路径：

"miDebuggerPath": "/usr/local/cuda-8.0/bin/cuda-gdb"

内容的提问来源于stack exchange，提问作者user2109066