如何在VS Code中使用GDB attach调试Python启动的C++子进程

问题原因 #

• 你当前将GDB附着到了Python父进程，subprocess.Popen创建的C二进制是独立的子进程，拥有单独的PID和地址空间，默认配置下GDB不会自动跟踪父进程fork出的子进程，因此无法捕获C程序的运行逻辑
• 你的调试配置中program字段填写的是Python解释器路径，GDB加载的是Python的符号表，没有加载你要调试的C++程序的调试符号，就算进入子进程也无法匹配你设置的源码断点
• 额外可能原因：C++程序编译时未添加-g参数生成调试信息，或编译后被strip移除了符号表，GDB无法将断点和源码位置对应

解决方法 #

方案1：直接附着C++子进程（操作最简单，推荐优先使用） #

• 修改Python代码，在subprocess.Popen行之后添加10~20秒的睡眠逻辑，预留足够的操作时间：

proc = subprocess.Popen( Command, shell=True    ,
                         stdout=sys.stdout      , 
                         stderr=subprocess.PIPE  )
import time
time.sleep(15) # 新增睡眠代码，调试完成后删除即可
return_code = proc.wait()

• 修改VS Code C调试配置：将program字段的值替换为你要调试的C二进制程序的绝对路径，其余配置保持不变
• 启动Python脚本后，触发VS Code的attach调试，在进程选择弹窗中选中你的C程序对应的进程（不要选Python进程），即可正常命中C源码断点

方案2：配置GDB自动跟踪子进程（无需修改Python代码） #

• 在你现有调试配置的setupCommands数组中新增两条GDB配置：

{
    "text": "set follow-fork-mode child",
    "description": "fork后自动跟踪子进程",
    "ignoreFailures": false
},
{
    "text": "set detach-on-fork off",
    "description": "fork后不脱离父进程，支持同时调试父子进程",
    "ignoreFailures": false
}

• 将配置中的program字段替换为C二进制程序的绝对路径，直接attach到Python父进程，当Python执行Popen创建子进程时，GDB会自动切换到子进程上下文，命中C断点
• 注意：如果你的Popen使用了shell=True，GDB会先跟踪到中间的shell进程，需要手动执行一次continue等shell启动C++程序后即可进入目标进程

方案3：修改C++程序主动等待调试（无需抢时间，100%命中） #

• 在C++程序的main函数开头添加等待调试的逻辑，仅调试编译时启用：

#include <unistd.h>
#include <cstdio>
int main(int argc, char* argv[]) {
    // 调试编译时添加-DDEBUG参数启用等待逻辑
    #ifdef DEBUG
    int wait_flag = 1;
    printf("C++进程PID：%d，等待调试器附着...\n", getpid());
    while (wait_flag) {
        sleep(1);
    }
    #endif
    // 原有业务逻辑
}

• 编译C程序时添加-g -DDEBUG参数，运行Python脚本后C程序会自动卡住等待，在VS Code中attach对应PID的C++进程，之后在GDB控制台执行set var wait_flag=0即可继续运行，断点必然命中

注意事项 #

• 所有调试场景下，C++程序编译必须添加-g参数生成调试信息，不要添加-s参数或执行strip操作移除符号
• 如果使用shell=True启动C++程序，进程列表中会出现额外的sh/bash进程，注意区分不要附着错进程

内容的提问来源于stack exchange，提问作者Dávid Papp