muGDB：Visual Studio Code的极简GDB调试适配器

muGDB是一个为Visual Studio Code设计的GDB调试适配器，采用TypeScript语言开发，旨在为那些无法顺利使用现有GDB扩展的用户提供一种简洁有效的解决方案。无论您是需要直接运行gdb，还是希望通过netcat或ssh进行远程调试，muGDB都能够满足您的需求。

为什么选择muGDB？

• 明确控制gdb启动：您可以明确指定如何启动gdb以及运行哪些命令。
• 灵活的调试方式：支持通过'debuggerArgs'或'file'命令传递调试目标，提供'launch'请求选项。
• 远程调试支持：通过netcat或ssh运行gdb，独立于gdb自身的远程调试能力。
• 连接已运行的gdb进程：通过提供主机名和端口号，或进程ID连接到已运行的gdb进程。

功能亮点：

• 命令补全
• 支持源代码、函数、指令和数据断点
• 所有断点类型支持条件、命中次数和日志记录
• 查看和单步执行反汇编代码
• 支持反向调试（在gdb支持的情况下）
• 以层次结构展示寄存器，基于gdb寄存器组
• 全局变量在独立作用域内展示
• 静态变量在存在时显示在额外作用域内
• 调试控制台接受原生gdb命令（以及MI命令），并格式化MI结果以提高可读性
• 通过python命令模拟python交互式环境
• 高效 - DAP命令直接发送到gdb，无需额外序列化

配置选项：

muGDB支持多种配置选项，帮助您个性化调试体验。以下是当前支持的所有设置：

• 启动请求配置：包括请求类型、gdb路径、调试器参数、工作目录、环境变量、能力覆盖、日志记录级别、启动命令、加载后命令、终止命令和源文件路径映射。

示例启动脚本：

提供两个示例启动脚本，展示如何配置muGDB以调试ESP32和通过ssh进行远程调试。

{
    "name": "ESP32 Debug muGDB",
    "type": "mugdb",
    "request": "launch",
    "debugger": "/Users/adrianstephens/.espressif/tools/xtensa-esp-elf-gdb/15.2_20241112/xtensa-esp-elf-gdb/bin/xtensa-esp32-elf-gdb",
    "debuggerArgs": [
        "/Volumes/DevSSD/dev/SkyNetLights/firmware/.pio/build/idf-nodemcu-32s/firmware.elf",
    ],
    "startupCmds": [
        "set remote hardware-watchpoint-limit 2",
        "set remote hardware-breakpoint-limit 2",
        "set target-async on",
        "target extended-remote :3333",
        "monitor reset halt",
    ],
    "postLoadCmds": [
        "thbreak app_main",
        "continue"
    ],
    "terminateCmds": [
        "del"
    ],
    "logging": "verbose",
    "preLaunchTask": "OpenOCD",
}

{
    "name": "muGDB ssh",
    "type": "mugdb",
    "request": "launch",
    "debugger":"ssh",
    "debuggerArgs": ["ubuntu-2404np", "gdb", "/home/adrian/Documents/dev/test/a.out"],
    "logging": "verbose",
    "startupCmds": [
        "set substitute-path ./stdio-common /usr/src/glibc/glibc-2.39",     //map files for gdb
        "set substitute-path ../sysdeps /usr/src/glibc/glibc-2.39/sysdeps",
        "set disassembly-flavor intel",
    ],
    "postLoadCmds": [
        "tbreak main",
        "run"
    ],
    "sourceMapping": {
        "" : "remote:", //add 'remote:' to all source files so we load through gdb
    }
}

通过muGDB，您可以更灵活、更高效地进行GDB调试，无论是本地还是远程环境。