OpenOCD配置文件必须严格匹配硬件和调试器：ST-Link需用stlink.cfg、DAP-Link用cmsis-dap.cfg、J-Link用jlink.cfg；芯片型号须对应target配置（如STM32G031K8必须用stm32g0x.cfg），且编译产物必须为含调试信息的ELF文件。
OpenOCD 配置文件必须匹配硬件和调试器
CLion 本身不内置 OpenOCD 配置逻辑，它只是调用你指定的 openocd 可执行文件，并传入你选的板级配置（.cfg）。如果烧录失败、连接超时或 GDB 连不上，90% 是因为 .cfg 文件没对上——比如用了 stm32f4x.cfg 去调 STM32G0，或者 interface/stlink.cfg 和实际 ST-Link 固件版本不兼容。
常见错误现象：adapter speed: 10000 kHz, but device only supports up to 4000 kHz、unable to find a matching configuration file、target halted due to debug-request, current mode: Thread 卡住不动。
- 检查你的调试器型号：ST-Link V2/V3、DAP-Link、J-Link，对应使用
stlink.cfg、cmsis-dap.cfg或jlink.cfg - 确认芯片型号后缀：STM32F407VG ≠ STM32F407ZG，但都可用
stm32f4x.cfg；而 STM32G031K8 必须用stm32g0x.cfg（旧版 OpenOCD 不含此文件，需升级到 v0.12.0+） - Windows 下注意路径分隔符：CLion 中填的
board/st_nucleo_f4.cfg实际会拼成C:/openocd/share/openocd/scripts/board/st_nucleo_f4.cfg，确保该路径真实存在且可读 - 若用自定义
.cfg（如 MSPM0 的ti_mspm0.cfg），必须把整个target/和interface/相关依赖也复制进项目或 OpenOCD 安装目录的scripts/子目录下
CLion 的 OpenOCD Run/Debug 配置关键项
CLion 在创建 STM32CubeMX 项目时会自动加一个 OpenOCD Download and Run 配置，但默认参数往往不能直接用。重点改这三项：
-
GDB client path：必须指向
arm-none-eabi-gdb（不是系统自带的gdb），路径如C:/tools/arm-gnu-toolchain/bin/arm-none-eabi-gdb.exe -
Board config：不要只写
stm32f4discovery.cfg，而应点右侧「辅助」按钮，从列表里选；若没对应项，就手动填绝对路径，或点「复制到项目并使用」——这样 CLion 会把配置文件拷进项目根目录，避免环境迁移失效 -
Reset options：勾选
Perform reset before debugging和After reset: Halt；若调试时程序跑飞，尝试取消勾选Reset and halt改为手动复位后再 attach
其它参数一般不用动：GDB port 默认 3333、Telnet port 默认 4444，除非你同时跑多个 OpenOCD 实例。
编译产物必须是 ELF 格式才能被 GDB 加载
CLion 默认生成的是 .elf，但如果你改过 CMakeLists.txt 或用了自定义构建流程，可能只输出 .bin 或 .hex。OpenOCD 调试时需要符号表和段信息，.bin 里没有这些，会导致断点无效、变量显示 <optimized out></optimized>、堆栈回溯失败。
验证方法：在终端运行 file your_project.elf，输出应含 ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV)；若看到 data 就说明是纯二进制。
- 确保 CMake 中未禁用
add_link_options(-Wl,-Map=${CMAKE_BINARY_DIR}/project.map)类链接选项 - 检查是否误加了
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -O binary")——这是给objcopy用的，不是链接器本身 - CLion 的 Build Target 应设为
all或具体elftarget，而非flash这类自定义目标（除非你明确重写了规则）
调试时看不到外设寄存器？SVD 文件得配对加载
CLion 的 SVD 支持是“可选增强”，不是开箱即用。即使 OpenOCD 连上了、GDB 能单步，寄存器视图仍是空的，大概率是 SVD 文件没加载或型号不匹配。
- SVD 文件必须与芯片型号严格一致：STM32F407VGT6 用
STM32F407xG.svd，不能用STM32F417.svd（哪怕只差一个字母） - 在 CLion 的 Run/Debug Configuration → Embedded GDB Server → SVD file 中，填绝对路径（如
C:/sdk/STM32Cube_FW_F4_V1.27.1/Utilities/cmsis/STM32F407xG.svd），不能用相对路径或环境变量 - 加载后可在 Debug 工具窗口中打开
Peripherals标签页；若仍为空，点右上角刷新图标，或检查 OpenOCD 日志里是否有Info : svd_load_file成功提示 - 部分新芯片（如 HPM6000、MSPM0）官方 SVD 更新滞后，此时需从 SDK 提取或手写 minimal SVD，否则寄存器名、地址偏移全错
最常被忽略的一点：SVD 加载成功不代表实时更新有效——某些外设（如 USB、ETH）寄存器访问受时钟门控影响，未使能时读出来全是 0，这不是 CLion 或 OpenOCD 的问题，而是硬件行为。
