clion调试无法启动90%非bug而是调试链路中断：需逐层验证cmake是否启用debug模式、可执行文件是否含debug_info、macos需勾选“allow running as root”、linux检查shell环境、arm64 windows避免lldb误用mi2参数、超时问题调高cldr.debugger.timeout值。
CLion 调试无法启动，90% 不是 bug，而是调试链路中某个环节断开了——得逐层验证，不能只盯着“Debug 按钮点不动”。
断点灰色、提示 unresolved 或直接 process exited with status -1
这是符号加载失败或权限拦截的典型表现，不是代码问题。
- 先确认 CMake 构建是否启用了调试信息：
CMAKE_BUILD_TYPE=Debug，且没加-DNDEBUG或-O2等覆盖优化选项 - 检查可执行文件是否带调试符号：
file ./cmake-build-debug/myapp输出里必须含with debug_info或not stripped - macOS 上常见
attach failed (Not allowed to attach to process)：不是证书问题，而是 CLion 启动时没继承系统调试权限；勾选Run → Edit Configurations → Allow running as root即可，比重装证书快 10 倍 - Linux 下若用非登录 shell 启动 CLion（比如从桌面快捷方式），
$SHELL可能未正确设置，导致调试器找不到环境；终端中执行export SHELL=/bin/sh && clion再试
报错 error: unknown option: --interpreter=mi2
这是 CLion 错把 LLDB 当成 GDB 用了，多见于 ARM64 Windows（如 Surface Pro X）或自定义 LLVM-MinGW 工具链场景。
- 根本原因：CLion 在调用
lldb.exe时硬塞了 GDB 专属参数--interpreter=mi2 - 验证方式：在终端手动运行
lldb.exe --help，输出里绝不会出现--interpreter - 临时绕过：改用 GDB 兼容工具链（如 MinGW-w64 的
gdb.exe），但需确保 ABI 匹配（x86_64 vs aarch64） - 长期解法：在
Settings → Build → Toolchains → Debugger中，不要直接填lldb.exe路径，改用 CLion 自带的LLDB（自动适配）或切换为GDB模式
Debug 控制台卡住、显示 Command Timed Out
不是程序卡死，是 CLion 等待调试器响应超时了，尤其在复杂数据结构或嵌入式环境里很常见。
- 默认超时是 30 秒（
cldr.debugger.timeout=30000），对 STM32 + OpenOCD 或 ROS2 节点这种启动慢的场景完全不够 - 进
Help → Find Action → Registry，搜cldr.debugger.timeout，改成120000（2 分钟）或更高 - 别忽略 OpenOCD 日志：如果它卡在
target halted due to debug-request，说明硬件复位没完成，要检查reset_config是否设为srst_only而非srst_nogate - ROS2 场景下，调试器常因未 source 环境变量而卡住；在运行配置中把
Executable改成/bin/bash，Program arguments填-c "source /opt/ros/humble/setup.sh && exec $MY_EXECUTABLE"
OpenOCD/ST-Link 连接成功但 SystemClock_Config 返回 HAL_ERROR
这是嵌入式调试最隐蔽的坑：OpenOCD 在 reset-init 阶段偷偷改了时钟，HAL 库再初始化就冲突了。
- 现象：烧录运行正常，一 Debug 就卡在
HAL_RCC_OscConfig返回HAL_ERROR - 根因：OpenOCD 的
reset-init脚本已启用 PLL（比如从 16MHz HSI 切到 64MHz），而 CubeMX 生成的SystemClock_Config()又试图重新配置同一 PLL - 解决：在 OpenOCD 配置中禁用自动时钟提升，把
adapter speed 8000改成adapter speed 2000，并注释掉所有mww写时钟寄存器的命令 - 更稳妥做法：在
main()开头加一段跳过时钟重配置的判断，或改用reset halt而非reset init
调试链路本质是多个子系统咬合运转：CMake 生成带符号的二进制 → CLion 找到它并传给调试器 → 调试器连上目标（本地进程或 OpenOCD）→ 目标允许被 attach。任一环松动，都会表现为“Debug 启动失败”，但错误信息往往指向错误的环节。
