如何在CLion中使用自定义OpenOCD与GDB参数运行调试会话？

针对你遇到的CLion调试会话挂起、脚本退出后CLion叠加自身参数的问题，直接通过调试配置而非启动前脚本实现需求是更可靠的方案，具体步骤如下：

1. 直接在调试配置中指定完整GDB参数 #

打开CLion的Run/Debug Configurations，新建或修改现有的Embedded GDB Server配置：

• 在GDB选项卡中，设置GDB executable为arm-none-eabi-gdb-py
• 在GDB command line arguments中填入所有自定义参数（注意不要加退出GDB的命令）：

  -ex "target extended-remote |openocd -c 'gdb_port 3333; log_output ./debug/openocd.log' -f interface/stlink.cfg -c 'transport select hla_swd' -f ./debug/stm32wbx.cfg -c 'stm32wbx.cpu configure -rtos auto'" -ex "source ./debug/gdbinit" -ex "source ./debug/FreeRTOS/FreeRTOS.py" -ex "source ./debug/flipperapps.py" -ex "fap-set-debug-elf-root build/f7-firmware-D/.extapps" -ex "source ./debug/PyCortexMDebug/PyCortexMDebug.py" -ex "svd_load ./debug/STM32WB55_CM4.svd" -ex "compare-sections build/latest/firmware.elf"
  

2. 拆分OpenOCD配置降低复杂度 #

把OpenOCD的命令单独抽成配置文件，减少GDB参数的复杂度，避免CLion解析时挂起：

• 创建./debug/openocd_custom.cfg文件，内容如下：

  gdb_port 3333
  log_output ./debug/openocd.log
  interface stlink
  transport select hla_swd
  source [find ./debug/stm32wbx.cfg]
  stm32wbx.cpu configure -rtos auto
  

• 然后将GDB参数中的target命令简化为：

  -ex "target extended-remote |openocd -f ./debug/openocd_custom.cfg"
  

3. 用统一GDB初始化脚本简化配置 #

把所有初始化命令集中到一个脚本文件，让配置更清晰：

• 创建./debug/clion_gdb_init.gdb，内容：

  source ./debug/gdbinit
  source ./debug/FreeRTOS/FreeRTOS.py
  source ./debug/flipperapps.py
  fap-set-debug-elf-root build/f7-firmware-D/.extapps
  source ./debug/PyCortexMDebug/PyCortexMDebug.py
  svd_load ./debug/STM32WB55_CM4.svd
  compare-sections build/latest/firmware.elf
  

• 在CLion调试配置的GDB选项卡中，要么在Startup script选择该文件，要么在GDB参数中用-ex "source ./debug/clion_gdb_init.gdb"替代多个单独的-ex命令。

关键注意事项 #

• 禁止在任何脚本或GDB参数中加入quit/exit命令，CLion需要维持GDB会话来控制调试流程，退出命令会导致CLion后续叠加自身参数失效或异常。
• 确认所有配置文件路径（OpenOCD cfg、GDB脚本、SVD文件等）都是相对于项目根目录的有效路径，避免因文件找不到导致会话挂起。
• 先在终端单独测试OpenOCD命令，确认能正常启动并连接目标设备，再配置到CLion中。

内容的提问来源于stack exchange，提问作者Игорь Данилов