CLion调试CMake项目本质是调试CMake配置阶段（cmake -S . -B build），而非可执行文件；仅CMake 3.27+支持DAP协议调试，需在project()、find_package()等有效命令行设断点，且须确保项目完全加载、DAP server成功启动。
CLion 调试 CMake 项目，本质是调试 CMake 配置阶段（即 cmake -S . -B build 这一步），不是调试你编译出来的可执行文件。 如果你误以为能单步跟踪 add_executable 执行后生成的二进制行为，会卡在“断点不命中”或“调试器无响应”上 —— 这是常见误解起点。
为什么 CMake Debug 配置总没反应？
CMake 调试只作用于 CMake 脚本解析和变量计算过程，且仅限 CMake 3.27+ 版本（使用 DAP 协议）。低于该版本、或未等项目完全加载就点 Debug，都会失败。
- 确保 CMakeLists.txt 已被 CLion 完全解析：观察右下角状态栏是否显示
Project loaded，且 CMake 工具窗口中没有红色错误日志 - 不要在
cmake_minimum_required行左侧 gutter 点击调试 —— 它不触发任何逻辑；应点在project()、find_package()或自定义function()调用行上 - 如果 CMake 生成失败（如 missing dependency），直接点击 CMake 工具窗口里的
Debug提示按钮，比手动设断点更可靠
如何创建并运行 CMake Debug 配置？
临时配置最简，但无法复用；永久配置适合团队协作或反复调试同一段逻辑。
- 打开顶层
CMakeLists.txt，在任意有效命令行（如set(MY_VAR "value")）左侧 gutter 点击，选择Debug—— CLion 自动创建临时CMake Debug配置 - 若要保存为永久配置：进入
Run | Edit Configurations→ 点击+→ 选CMake Debug→ 填写名称，指定CMake profile（对应你当前使用的 CMake 配置文件）→ 点击OK - 注意：
CMake Debug不会重新加载项目模型，调试完修改了变量也不自动刷新 Targets 列表；需手动Reload CMake project
调试时哪些断点有效，哪些无效？
CMake 调试器支持行断点和函数断点，但对宏、注释、空行、include() 内部逻辑支持有限。
- ✅ 有效的断点位置：
if()条件入口、foreach()循环头、自定义function(my_func)的第一行、message(STATUS ...)前一行 - ❌ 无效的断点位置：
# 注释行、set(VAR ${OTHER_VAR})中的${OTHER_VAR}展开处（无法停在变量展开内部）、include("file.cmake")的括号内（只能在被 include 文件里设断点） - ⚠️ 特别注意：
add_executable()和target_link_libraries()是“声明式调用”，断点停在这里只看到参数传递，看不到链接过程 —— 那属于构建阶段，不在 CMake Debug 范围内
调试失败时先看哪里？
多数问题出在环境隔离或协议不匹配，而不是脚本本身。
- 检查 CLion 设置：
Settings | Build, Execution, Deployment | CMake→ 确认所选工具链的 CMake 可执行路径版本 ≥ 3.27 - 查看 CMake 工具窗口底部的
Debug Adapter Protocol日志，出现DAP server started才算启动成功；若报Failed to launch DAP server，说明插件或权限问题 - 禁用所有非必要插件（尤其第三方 CMake 插件），CMake Debug 功能由 CLion 原生实现，外部插件易冲突
- 如果用 WSL 或远程开发，确认远程端已安装
cmake且 PATH 可见 ——CLION_IDE环境变量存在不代表 CMake 进程能访问它
真正容易被忽略的是：CMake Debug 一旦启动，就锁定当前 CMake 缓存状态；你在调试中改了 CMakeLists.txt 并保存，不会自动重载，必须手动终止调试并重新触发。这不是 bug，是设计使然 —— 它调试的是“一次生成过程”的快照，不是活的编辑器。
