VSCode无法调试Cython封装CUDA代码 命令行cuda-gdb可正常调试

问题根因与解决步骤 #

1. 首先修复方案3进程直接退出的问题
   你当前launch配置里的args字段格式错误：cuda-gdb类型的调试配置要求args必须传入字符串数组，你直接写单个字符串会导致Python解释器把带空格的完整路径识别成单个非法参数，直接抛出参数错误退出，你看到的退出码02就是参数解析失败的标准返回值，把args改成和你cppdbg配置里一样的数组格式即可。

2. 补全cuda-gdb启动配置的必填项
   你之前的配置缺了cuda-gdb调试动态库必需的参数，直接用下面的配置替换原有launch项：

{
    "name": "CUDA Cython Python 调试",
    "type": "cuda-gdb",
    "request": "launch",
    "program": "/home/jeff/JTDev/venv/bin/python3",
    "args": [
        "/home/jeff/JTDev/03 Cython/JTCudaLibCython/test.py"
    ],
    "cwd": "${workspaceFolder}",
    "stopAtEntry": false,
    "environment": [
        {"name": "CUDA_DEVICE_WAITS_ON_EXCEPTION", "value": "1"}
    ],
    "setupCommands": [
        {"text": "set breakpoint pending on", "ignoreFailures": false},
        {"text": "set non-stop off", "ignoreFailures": false},
        {"text": "set cuda break_on_launch application", "ignoreFailures": true}
    ]
}

配置说明：

• set breakpoint pending on：允许cuda-gdb在动态库（即你编译的Cython .so库）还没加载的时候就预设断点，等库加载后自动绑定断点地址
• set non-stop off：关闭gdb的非停止调试模式，cuda-gdb的GPU调试逻辑不支持该模式，开着会导致断点无响应
• CUDA_DEVICE_WAITS_ON_EXCEPTION=1：保证GPU内核触发断点/异常时不会直接跑飞，能停在对应代码行

3. 排查编译环节的符号丢失问题
   确认你Cython封装CUDA的编译配置满足调试要求：

• CUDA代码编译必须加-g -G -O0参数，-G是生成GPU侧调试符号的必需参数，不能漏，同时关掉所有编译优化，不要开LTO链接时优化
• Cython的setup.py编译配置里要加extra_compile_args=['-g','-G','-O0'], extra_link_args=['-g']，不要加-s参数（该参数会strip掉所有调试符号）
• 保证编译时用的.cu源文件路径和你VSCode里打开下断点的源文件路径完全一致，不要移动编译后的.so文件之后再在原路径下断点，会导致符号地址映射失败

4. 另外3种方案失效的核心原因

• 两种attach附加调试模式失效：cuda-gdb对动态加载的共享库GPU符号有加载时序要求，必须在Python进程启动前就通过cuda-gdb拉起进程，等.so库被Python加载时自动绑定符号；如果先启动Python进程再附加，cuda-gdb无法正确映射GPU端的符号地址，断点自然无法命中
• cppdbg模式无法命中GPU断点：cppdbg默认调用系统原生gdb，不是NVIDIA定制的cuda-gdb，原生gdb完全不识别CUDA设备端的符号表，只能调试CPU侧的C/C++/Cython代码，自然无法停在GPU内核断点上

5. 前置校验项

• 确认VSCode安装的Nsight插件版本和你本地的CUDA 11.7版本完全匹配，版本不兼容会导致调试器启动无输出，装完插件必须重启VSCode生效
• 修改ptrace_scope权限之后必须重启VSCode，VSCode如果是在权限修改前启动的，进程本身没有拿到ptrace调试权限，会导致附加/启动调试失败
• 调试前先在终端手动执行cuda-gdb <你的Python解释器路径>，进入交互界面后执行run <你的test.py路径>，确认命令行下能正常命中GPU断点，再回VSCode启动调试，先排除环境本身的问题
• 断点不要打在Cython生成的中间.cpp文件上，GPU端断点必须打在原始的.cu源文件对应代码行，Cython封装层的CPU侧断点可以打在.pyx文件上

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