VSCode调试STM32时卡在‘等待调试器连接’超时问题排查

问题背景 #

尝试使用STLINK-V3调试探针配置VSCode调试STM32设备：

• GDB服务器可正常启动并与探针通信
• 手动启动VSCode配置的同款GDB，能连接GDB服务器并正常调试
• VSCode自身启动的GDB实例却卡在“等待调试器连接”环节超时，已排除端口不匹配问题

当前的launch配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch",
      "type": "cppdbg",
      "request": "launch",
      "cwd": "${workspaceFolder}",
      "program": "${command:cmake.launchTargetPath}",
      "MIMode": "gdb",
      "miDebuggerPath": "${config:STM32VSCodeExtension.cubeCLT.path}/GNU-tools-for-STM32/bin/arm-none-eabi-gdb.exe",
      "miDebuggerServerAddress": "localhost:3333",
      "debugServerPath": "${config:STM32VSCodeExtension.cubeCLT.path}/STLink-gdb-server/bin/ST-LINK_gdbserver.exe",
      "debugServerArgs": "--stm32cubeprogrammer-path ${config:STM32VSCodeExtension.cubeCLT.path}/STM32CubeProgrammer/bin --swd --port-number 3333",
      "serverStarted": "Waiting for connection on port .*\\.\\.\\.",
      "stopAtConnect": true,
      "postRemoteConnectCommands": [
        {
          "text": "load ${command:cmake.buildDirectory}/${command:cmake.launchTargetFilename}"
        }
      ],
      "logging": {
        "engineLogging": true
      },
      "preLaunchTask": "Build",
      "svdPath": "${config:STM32VSCodeExtension.cubeCLT.path}/STMicroelectronics_CMSIS_SVD/STM32H735.svd"
    }
  ]
}

可能的故障原因 #

• serverStarted正则匹配失效：VSCode依赖这个正则判断GDB服务器是否完全启动，若实际输出日志和正则不匹配，会一直等待连接触发。查看ST-LINK GDB服务器的真实启动日志，比如实际输出可能是Waiting for connection on port 3333...，可将正则调整为"Waiting for connection on port.*"或精确匹配的内容。
• GDB路径变量解析异常：手动启动GDB正常，但VSCode调试环境中${config:STM32VSCodeExtension.cubeCLT.path}变量可能未正确解析。尝试将miDebuggerPath替换为绝对路径（如"D:/STM32CubeCLT/GNU-tools-for-STM32/bin/arm-none-eabi-gdb.exe"）验证。
• 服务器启动等待时间不足：VSCode默认的serverLaunchTimeout为10000毫秒，若GDB服务器启动较慢，可添加配置"serverLaunchTimeout": 20000延长等待时长。
• postRemoteConnectCommands路径错误：${command:cmake.buildDirectory}/${command:cmake.launchTargetFilename}可能指向无效路径，导致GDB连接后执行load命令失败，VSCode误判连接异常。可暂时注释该命令，或替换为绝对路径测试。
• cppdbg插件兼容性问题：部分版本的cppdbg插件与ST-LINK GDB服务器存在兼容性冲突，尝试更新插件到最新版本，或回退至稳定版。

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