<p>直接删掉 CMake 缓存目录最可靠：关闭 CLion 后删除 cmake-build-* 文件夹和 .idea/cmake 目录，再重新打开项目触发自动重配置；仅 Reload 项目不重建 CMake 构建树，无法修复 target 丢失、源文件未纳入、标准版本失效等问题。</p>
CLion 项目配置被破坏或失效时，直接删掉 CMake 缓存目录最可靠
CLion 的项目配置本质是 CMake 生成的构建产物 + IDE 自己缓存的元数据。一旦 CMakeLists.txt 改动、工具链切换、或 IDE 升级后索引错乱，就可能出现“找不到 target”“无法识别 main()”“运行配置灰色不可用”等现象。此时不要尝试手动修 CMakeCache.txt 或改 XML 配置文件——90% 情况下会越修越糟。
真正起效的操作只有两步：
- 关闭 CLion（必须关，否则缓存文件被占用）
- 删除项目根目录下的
cmake-build-*文件夹（比如cmake-build-debug、cmake-build-release）和.idea/cmake目录 - 重新打开项目，CLion 会自动触发 CMake 重新配置（Re-import）
注意：如果用了 CMake Presets（CMakePresets.json），删完后首次加载会提示你选择 preset；如果没用 preset，它会按 Settings | Build, Execution, Deployment | CMake 里当前选中的配置类型重建。
为什么不能只点 “Reload project” 或 “Reload CMake project”？
菜单里的 File → Reload project 或右键 CMakeLists.txt → Reload project 只刷新 IDE 的符号索引和部分缓存，**不重建 CMake 构建树**，也不清空旧的 CMakeCache.txt。很多问题（如新增源文件未被 file(GLOB) 扫到、include 目录未生效）根本不会修复。
常见错误现象包括：
- 新添加的
.c文件在左侧 Project 视图里显示为灰色，提示 “Not included in any target” - 修改了
set(CMAKE_C_STANDARD 17)，但 CLion 仍报 C11 语法错误 - 运行配置里 executable 路径还是旧的，点开却是
Not selected
这些都说明底层 CMake 生成逻辑没重跑，光 reload 不顶用。
STM32CubeMX 项目要额外清理 .ioc 关联缓存
如果你的项目是从 STM32CubeMX 导出的（即含 Core/Startup 目录、Drivers/ 和 .ioc 文件），CLion 会在 .idea/misc.xml 里记录 CubeMX 工程路径和生成时间戳。即使你已用 CubeMX 重新 generate code，CLion 也可能继续用旧的头文件路径或启动文件。
此时需补充操作：
- 删掉
.idea/misc.xml中与stm32cube相关的 block（搜索cubemx或ioc） - 或者更稳妥：删整个
.idea目录（项目设置会丢失，但 CMake 配置和代码不会） - 重启 CLion 后，它会重新解析
.ioc并同步驱动路径、CMSIS 版本、HAL 库链接方式
不这么做，你可能会发现 HAL_GPIO_Init() 报 unresolved symbol，其实是 CLion 还在引用旧版 HAL 的 stm32f4xx_hal_gpio.c。
重新创建后运行配置仍是临时的？检查是否漏选 “Enable”
重新导入后，CMake Targets 有了，但 Run/Debug 配置可能还是半透明图标（临时配置），点运行时报 No executable specified。这不是配置没建好，而是你没主动启用目标对应的运行配置。
正确做法是：
- 打开
Run → Edit Configurations… - 左侧选中你的 target（比如
my_project.elf） - 右侧确保
Executable字段已自动填入构建产物路径（如cmake-build-debug/my_project.elf） - 最关键一步：勾选
Enable复选框（位于配置顶部，常被忽略） - 点击
Apply→OK
没勾这个，CLion 就当这个配置是“仅用于调试符号加载”，不把它当可执行入口。这也是为什么很多人 reload 后能 debug 却 run 不起来。
真正麻烦的不是步骤多，而是 CMake 缓存、IDE 元数据、CubeMX 关联这三层状态经常不同步。每次怀疑配置异常，先删 cmake-build-* 和 .idea/cmake，比查日志快十倍。
