如何使用VSCode调试Python subprocess.check_call调用的C++程序

直接按步骤配置即可实现混合调试，不需要修改业务核心逻辑。 #

前置准备 #

• 编译C++代码时必须生成带调试符号的版本：Linux/macOS下用GCC/Clang编译加-g -O0参数，关闭优化、保留调试信息；Windows下用MSVC选择Debug编译模式，生成带/Zi符号的可执行文件。
• 确认subprocess.check_call(cmdline)里传入的cmdline指向的就是上述编译出的Debug版C++可执行文件，不要误调用Release版、被strip过的版本。

方案1：手动附加调试（通用无配置门槛） #

• 在Python代码的subprocess.check_call(cmdline)这行打行断点，启动Python调试，让程序运行到这行自动暂停。
• 切到VSCode「运行和调试」面板，新建调试配置：Linux/macOS选C/C++: (gdb/lldb) 附加，Windows选C++ Windows 附加。
• 回到Python调试会话，按F10单步执行check_call行，拉起C进程。如果C程序运行速度太快，还没附加就执行完，可以在C++代码的main函数最开头加临时等待逻辑，预留附加时间：

  // Linux/macOS 版本
  #include <unistd.h>
  int main() {
      sleep(10); // 启动后等待10秒，足够完成附加操作
      // 原有业务代码
  }
  

  // Windows 版本
  #include <windows.h>
  int main() {
      Sleep(10000); // 单位是毫秒，等10秒
      // 原有业务代码
  }
  

  调试完成后删掉这段等待代码即可。
• C进程启动后，立刻切回之前准备好的C附加配置，在进程列表里选中对应C可执行文件的进程完成附加，之后你在C代码里打的断点就会正常命中，可以单步调试C++逻辑。

方案2：复合调试配置（体验流畅，不用手动抢时间附加） #

通过VSCode的复合调试配置，一次启动同时挂载Python和C++调试器，配置一次后续可以直接用：

1. 打开项目根目录下的.vscode/launch.json文件，没有的话就新建一个。
2. 写入如下配置，注意替换注释里标注的路径、调试器类型为你自己的环境参数：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "启动Python入口",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/你的Python入口文件.py",
            "console": "integratedTerminal",
            "justMyCode": false
        },
        {
            "name": "附加C++子进程",
            "type": "cppdbg",
            "request": "attach",
            "program": "${workspaceFolder}/你的Debug版C++可执行文件路径",
            "MIMode": "lldb", // 用gdb就填gdb，Windows下MSVC调试改成对应type
            "stopAtEntry": true
        }
    ],
    "compounds": [
        {
            "name": "Python+C++混合调试",
            "configurations": ["启动Python入口", "附加C++子进程"],
            "stopAll": true
        }
    ]
}

3. 配置完成后，在调试面板选中「Python+C混合调试」选项启动：程序会先运行到Python侧check_call的断点，按F10拉起C进程后，调试器会自动附加到C进程，直接停在C程序入口，不需要手动选进程。

常见问题排查 #

• C断点不命中：优先检查调用的C可执行文件是不是带调试符号的Debug版本，确认编译时关闭了优化选项，路径配置和实际编译输出路径一致。
• 附加时找不到对应C进程：如果check_call传了shell=True参数，实际会先启动shell进程再拉起C，可以去掉shell=True参数，或者找进程时注意区分shell进程和实际C++进程。
• C++变量显示<optimized out>：说明编译开了O2/O3优化，把编译优化等级改成-O0重新编译即可。

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