VSCode 配置 ROS2 Launch 调试环境(Attach 方式)

VSCode 配置 ROS2 Launch 调试环境(Attach 方式)

适用环境:

Ubuntu + ROS2 Foxy + colcon + VSCode + C++(rclcpp)

推荐方式:使用 ros2 launch 启动整个系统,再 attach 调试单个节点

参考链接:vscode中使用断点 调试ROS功能包(一)

在 vscode 中断点调试 ROS2 C++ 的办法

1. 安装ROS2插件

2. 创建.vscode配置文件

launch.json

bash 复制代码
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Attach to search_manager",
            "type": "cppdbg",
            "request": "attach",
            "program": "${workspaceFolder}/install/test_node/lib/test_node/test_node",
            "processId": "${command:pickProcess}",
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

settings.json

bash 复制代码
{
    "ROS2.distro": "foxy",
    "ROS2.rosSetupScript": "${workspaceFolder}/install/setup.bash",
    "files.associations": {
        "*.hpp": "cpp",
        "*.h": "cpp",
        "*.c": "cpp",
        "*.cpp": "cpp"
    }
}

tasks.json

bash 复制代码
{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "colcon build (Debug)",
            "type": "shell",
            "command": "/bin/bash",
            "args": [
                "-c",
                "source /opt/ros/foxy/setup.bash && source ${workspaceFolder}/install/setup.bash && colcon build --cmake-args -DCMAKE_BUILD_TYPE=Debug --symlink-install"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "presentation": {
                "reveal": "always"
            },
            "problemMatcher": []
        }
    ]
}

3. 编译

在 VSCode 中执行快捷键Ctrl + Shift + B,选择colcon build (Debug)

4. 运行

  • 终端启动 ROS2 Launch

⚠️ 必须在Linux终端启动,而不是 VSCode launch

bash 复制代码
source /opt/ros/foxy/setup.bash
source install/setup.bash
ros2 launch test_node test.launch.py
  • 打开源码设置断点

  • 启动调试 : VScode终端按下F5,选择需要调试的进程即可

问题1:launch.json,settings.json,tasks.json的区别是什么?

1. tasks.json ------ 负责编译

相当于在终端输入:

bash 复制代码
source /opt/ros/foxy/setup.bash
colcon build --cmake-args -DCMAKE_BUILD_TYPE=Debug
问题 解决方式
每次手动敲 build 命令 Ctrl+Shift+B 一键编译
忘记 Debug 编译 强制 Debug
环境变量没加载 在 command 里 source

2. launch.json ------ 负责调试器行为

  • 使用 gdb
  • 附加到某个运行中的进程
  • 让断点生效
问题 解决方式
断点不生效 Debug 模式 + gdb
多节点系统不好直接启动 用 attach
launch 参数丢失 终端启动 + attach

3. settings.json ------ 负责编辑器行为

  • 指定 ROS2 发行版(foxy)
  • 指定 setup.bash 路径
  • 帮助 IntelliSense 识别头文件
  • 控制 C++ 代码提示
问题 解决方式
找不到 rclcpp 头文件 设置 ROS2.distro
代码红线但能编译 配置 include
智能提示失效 指定 cmake provider

4. 三者关系图

复制代码
                ┌──────────────┐
                │ settings.json│
                │ (代码提示)    │
                └──────┬───────┘
                       │
                       ▼
修改代码 ──→ Ctrl+Shift+B ──→ tasks.json ──→ colcon build
                       │
                       ▼
终端 ros2 launch
                       │
                       ▼
F5 ──→ launch.json ──→ gdb attach

5. 角色分工

文件 职责 是否必须
tasks.json 编译 ✅ 必须
launch.json 调试 ✅ 必须
settings.json 代码提示 ⚠ 建议
相关推荐
张紫娃3 小时前
idea 如何看一个类的 .class 文件
java·ide·intellij-idea
NoteDeep 深度笔记8 小时前
DOM 被改乱了怎么办?Notedeep 编辑器的 normalize 设计
前端·javascript·编辑器
顧棟12 小时前
组件生命周期设计:从硬编码初始化到状态机
java·ide
jianqiang.xue1 天前
Espressif-IDE进入维护模式:乐鑫把ESP32开发的宝押给VS Code
前端·css·ide
Solange__3 天前
Blender 3D模型优化:普通复制、共享网格、实例、合并怎么选?
人工智能·3d·ai·自然语言处理·编辑器·blender·材质
2601_967980113 天前
世界上最好的Python编辑器是什么?我投PyCharm一票
ide·python·pycharm·数据科学·jupyter notebook
FungLeo4 天前
成为全栈·Vue 管理后台篇·编辑器图片上传:从文件选择到文章附件关联
前端·vue.js·编辑器·markdown·文件上传·formdata·附件管理
拼图2095 天前
VSCode 正则表达式使用指南
ide·vscode·正则表达式