clion调试必须手动确认三件事：运行配置是否可用、调试器是否就位、断点是否被识别。临时配置图标半透明易丢失，带红叉提示路径或目标错误；调试器需版本≥8.0且路径正确；断点为灰色说明无对应可执行代码，须确保源文件被cmake包含并启用-g调试信息。
CLion 创建项目后调试不依赖“自动就绪”，必须手动确认三件事：运行配置是否可用、调试器是否就位、断点是否被识别。缺一不可。
检查 Run/Debug Configuration 是否存在且有效
新创建的 C++ 项目（比如选 C++ Executable 模板）通常会自动生成一个临时配置，但图标是半透明的——说明它没被保存为永久配置。这种临时配置在重启 CLion 或清理缓存后可能丢失。
- 点击右上角运行按钮旁的下拉箭头，看是否有类似
main或项目名的配置项；如果没有，说明还没生成，需先点击 ▶ 运行一次触发创建 - 若配置图标带红色叉号，把鼠标悬停上去，会提示具体错误，常见的是
Executable path is empty或Target not found——本质是 CMake 没成功构建出可执行文件 - 临时配置最多保留 5 个，新增时旧的会被删掉；如需长期使用，务必点击下拉菜单里的
Save Configuration
确认 GDB 或 LLDB 已正确配置
CLion 默认用系统 PATH 中的调试器，但 Windows 上 MinGW 自带的 gdb.exe、macOS 上 Xcode 的 lldb、Linux 上的 gdb 都可能版本过旧或缺失符号支持，导致断点灰色、无法步进。
- 进入
Settings → Build, Execution, Deployment → Toolchains，检查Debugger字段是否指向有效的二进制，比如gdb.exe或/usr/bin/gdb - 在终端中直接运行
gdb --version，确保输出版本 ≥ 8.0；低于该版本可能无法解析现代 C++ 的 DWARF 调试信息 - 嵌入式项目（如 STM32）必须用
arm-none-eabi-gdb，且需与 OpenOCD 版本兼容（OpenOCD 0.12+ 推荐配 GDB 12+）
验证断点是否真正生效
绿色实心圆点 ≠ 断点已就绪。CLion 里断点变灰色、悬停显示 Line breakpoint won't be hit: No executable code is associated with this line 是最常被忽略的问题。
- 确保你是在
main()或其他实际被调用的函数内打的断点；模板生成的main.cpp若未被 CMakeadd_executable包含，就不会编译进去 - 检查 CMake 构建日志里有没有 warning：例如
source file not in target或target 'xxx' has no sources - 如果用了
set(CMAKE_BUILD_TYPE Debug)但忘了加-g编译选项，或者 CMakeLists.txt 里写了set(CMAKE_CXX_FLAGS_RELEASE "-O3")却没覆盖 Debug 模式，也会导致调试信息缺失
最容易被跳过的其实是 CMake 构建状态本身——调试前不点一下 ▶ 或者不看右下角是否显示 Build finished，就直接点虫子图标，大概率会卡在 “Connecting to debugger…”。CLion 不会在后台默默帮你重构建，它只调试当前已存在的可执行文件。
