cmakelists.txt修改后需手动重载才生效，clion不会自动触发；右键文件选“reload cmake project”或按ctrl+shift+o强制刷新，否则新增源文件、头文件路径、编译标准等均不生效。
CMakeLists.txt 文件改了但没生效
CLion 不会自动重载修改后的CMakeLists.txt，哪怕你保存了文件，IDE 仍按旧配置解析项目结构、补全、跳转和构建。最直接的表现是：新增的源文件不进项目树、#include 找不到头文件、add_executable 加了新目标却在运行配置里看不到。
必须手动触发重载。方式有两种：
- 右键点击项目根目录下的
CMakeLists.txt→ 选择 “Reload CMake project” - 或点击顶部菜单栏 File → Reload project
Settings | Build, Execution, Deployment | CMake 中的 “Automatically reload CMake project on editing”，它只对简单变更（如注释、空行）响应，一旦涉及 add_executable、include_directories 或 file(GLOB) 等结构性改动，依然得手动 reload。
添加新源文件后编译报错“undefined reference”或“no such file or directory”
CMakeLists.txt 没把文件真正纳入构建流程。常见错误写法是只把文件加进 IDE 项目（比如右键新建 .c），却忘了告诉 CMake：“这个文件要参与编译”。
正确做法取决于你用的是显式列表还是自动收集：
- 显式模式（推荐小项目）：在
add_executable或add_library的参数里，**逐个列出所有.c或.cpp文件名**，例如：add_executable(myapp main.c utils.c parser.c) - 自动模式（适合多文件项目）：用
file(GLOB_RECURSE sources "*.c" "*.cpp")收集，再传给add_executable；但要注意——GLOB不会自动检测新增文件，**必须 reload CMake 才会重新扫描磁盘**
.h），仅放源码目录还不够；若 #include "xxx.h" 报错，大概率是缺 include_directories() 路径，比如 include_directories(Core/Inc Core/U8g2)。
修改 CMAKE_C_STANDARD 或 CMAKE_CXX_STANDARD 后标准库函数仍报错
CMake 标准设置只影响编译器命令行的-std= 参数，但它不控制头文件可见性。典型现象：开了 C11 却用不了 stdatomic.h，或设了 CXX17 但 std::optional 提示未声明。
原因有两个：
- 编译器本身不支持该标准（比如 GCC 4.8 不支持 C11 完整特性），需确认
cmake --version和实际使用的编译器版本兼容 - CLion 默认使用 bundled MinGW 或 Clang，可能不是你系统 PATH 里的新版工具链；可在
Settings | Build, Execution, Deployment | Toolchains里指定完整路径的gcc或clang
CMakeLists.txt 末尾加一行 message(STATUS "C standard: ${CMAKE_C_STANDARD}")，reload 后看 Event Log 是否输出预期值。
第三方库（如 OpenCV、U8g2）头文件能识别，但链接时报 undefined reference
头文件路径（include_directories）和链接库（target_link_libraries）是两件事。只配前者，编译能过，链接必挂。
关键步骤顺序不能错：
- 先用
find_package(OpenCV REQUIRED)或find_package(Eigen3 REQUIRED)探测库位置（确保已安装且CMAKE_PREFIX_PATH包含其share/目录） - 再用
target_include_directories(myapp PRIVATE ${OpenCV_INCLUDE_DIRS})告诉编译器去哪找.h - 最后用
target_link_libraries(myapp PRIVATE ${OpenCV_LIBS})告诉链接器连哪些.a或.so
PRIVATE 表示只本 target 用，不传递给依赖它的其他 target；如果写成 PUBLIC 却没提供对应头文件路径，下游 target 可能编译失败。
CMake 配置里最容易被忽略的，其实是路径的相对基准——所有 include_directories、add_executable 中的文件路径，都是相对于 CMakeLists.txt 所在目录的，不是相对于当前编辑的文件，也不是相对于 CLion 项目根目录。
