如何在VS Code中同时调试Python和C++编写的ROS2节点

我刚好之前处理过类似的跨语言ROS2调试场景，结合你用Ubuntu22.04、VS Code的情况，给你一步步拆解怎么同时调试Python写的GUI节点和C++的robotMainStart节点：

一、先做好前置准备 #

• 首先确认VS Code里装了必要的插件：C/C++（微软官方款）、Python（同样官方插件）、ROS（专门的ROS2支持插件），这些插件能帮我们自动识别ROS2结构，少踩很多配置坑。
• 把你的robot_ws包编译成Debug模式！这个是关键中的关键，我之前就是忘了这一步，C++断点死活不生效。在终端里跑这个命令就行：

  colcon build --cmake-args -DCMAKE_BUILD_TYPE=Debug --packages-select robot_ws
  

  只编译robot_ws就够，GUI是Python包不用编译，接口包正常编译过就行。
• 确保VS Code启动时已经加载了ROS2环境变量：要么启动VS Code前在终端里执行source /opt/ros/humble/setup.bash和source ./install/setup.bash，要么在VS Code设置里配置终端自动source（搜"terminal.integrated.profiles.linux"，给bash加启动命令）。

二、配置launch.json文件 #

打开VS Code的「运行和调试」面板，点击「创建launch.json文件」，选择「ROS」模板，然后把下面的配置替换进去（记得根据你的实际路径调整）：

{
  "version": "0.2.0",
  "configurations": [
    // C++节点的调试配置
    {
      "name": "Debug C++ Robot Node",
      "type": "cppdbg",
      "request": "launch",
      // 替换成你的robotMainStart节点实际路径，install后在lib目录下
      "program": "${workspaceFolder}/install/robot_ws/lib/robot_ws/robotMainStart",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${workspaceFolder}",
      "environment": [
        "ROS_DOMAIN_ID=0",
        "ROS_LOCALHOST_ONLY=1"
      ],
      "externalConsole": false,
      "MIMode": "gdb",
      "setupCommands": [
        {
          "description": "Enable pretty-printing for gdb",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        }
      ]
    },
    // Python节点的调试配置
    {
      "name": "Debug Python GUI Node",
      "type": "python",
      "request": "launch",
      // 替换成你的GUI节点脚本实际路径
      "program": "${workspaceFolder}/src/gui/scripts/gui_main.py",
      "args": [],
      "cwd": "${workspaceFolder}",
      "env": {
        "PYTHONPATH": "${workspaceFolder}/install/gui/lib/python3.10/site-packages:${PYTHONPATH}",
        "ROS_DOMAIN_ID": "0",
        "ROS_LOCALHOST_ONLY": "1"
      },
      // Ubuntu22.04默认Python3.10，根据实际情况调整
      "python": "/usr/bin/python3",
      "console": "integratedTerminal"
    }
  ],
  // 配置复合调试，让两个节点同时启动
  "compounds": [
    {
      "name": "Debug Both Nodes",
      "configurations": ["Debug C++ Robot Node", "Debug Python GUI Node"],
      // 要是需要调整启动顺序，比如先启动C++节点，这里可以加preLaunchTask
      "preLaunchTask": ""
    }
  ]
}

三、开始调试 #

1. 分别在你的Python GUI脚本和C代码里设置断点：Python的断点直接点击行号左边就行，C的断点要在Debug编译后才能正常触发。
2. 打开「运行和调试」面板，在顶部下拉菜单里选「Debug Both Nodes」，点击绿色启动按钮。
3. 这时候两个调试器会同时启动，你可以在调试控制台分别查看两个节点的输出，也能单步调试、查看变量，完全不影响彼此。

我踩过的坑给你提个醒 #

• 如果C++节点启动失败，先在终端里直接跑ros2 run robot_ws robotMainStart，确认节点本身能正常运行，再排查调试配置的路径问题。
• Python节点要是报导入错误，检查env里的PYTHONPATH有没有包含install后的包路径，ROS2的Python包必须安装后才能被正确导入。
• 要是必须等C节点初始化完成再启动Python GUI，可以给复合调试加preLaunchTask，或者在Python代码里加个简单的轮询逻辑（比如每隔1秒查一次C节点是否上线）。

内容来源于stack exchange