clion 项目能否正常构建、导航、补全取决于 cmakelists.txt 是否正确定义源文件、头文件路径和目标依赖；需手动 reload 或启用自动重载，路径须相对于 cmakelists.txt，头文件需用 target_include_directories 声明，子目录需 add_subdirectory 引入。
CLion 项目能否正常构建、导航、补全，不取决于文件是否“在目录里”，而取决于 CMakeLists.txt 是否正确定义了源文件、头文件路径和目标依赖——这是绝大多数新手卡住的根源。
为什么改了 CMakeLists.txt 后 CLion 还不识别新文件
CLion 不会自动监听 CMakeLists.txt 的变更并重载项目。它只在以下三种情况触发重新解析：
- 手动点击右键菜单中的 Reload CMake Project
- 启用设置中
Automatically reload CMake project on editing（Settings | Build, Execution, Deployment | CMake） - 切换 CMake 配置文件（比如从 Debug 切到 Release）
常见错误现象：在 src/ 下加了 utils.c 和 utils.h，也改了 add_executable(myapp main.c utils.c)，但 CLion 仍标红 #include "utils.h"。原因就是没 reload。
注意：Reload CMake Project 会清空当前 cmake-build-* 目录下的缓存，但不会删除你手写的 CMakeLists.txt —— 它只读取，不覆盖。
add_executable() 里漏文件或路径写错的典型表现
add_executable() 的参数是**相对于 CMakeLists.txt 所在目录的路径**，不是相对于当前编辑的 .cpp 文件，也不是相对于 CLion 项目根目录（除非两者重合）。
- 如果
CMakeLists.txt在项目根目录，而utils.c在src/utils.c，就必须写add_executable(myapp src/utils.c)，不能只写utils.c - 若使用变量（如
set(SOURCES main.c src/utils.c)），记得用${SOURCES}展开，不能漏${}包裹 - CLion 在你添加新文件时会弹出 “Add to CMake project” 提示，点它会自动补全到
add_executable()或对应target_sources()中——但仅限当前 CMakeLists.txt 所在作用域
错误信息示例：CMake Error: Cannot find source file "utils.c"，说明路径拼写错误或文件确实不在指定位置；undefined reference to 'xxx' 则更可能是文件进了构建但没被链接进 target（比如加到了错误的 add_executable() 调用里）。
头文件找不到（#include not found）的真正原因和解法
CLion 标红 #include "xxx.h"，90% 是因为 CMake 没告诉编译器去哪里找这个头文件，而不是文件不存在。
-
include_directories(inc)是最常用方式，但它是全局生效的——会影响所有后续add_executable()和add_library()，容易引发命名冲突 - 更推荐用
target_include_directories(myapp PRIVATE inc)，作用域明确，且PRIVATE表示只供 myapp 内部使用，不传递给依赖它的其他 target - 路径必须是相对于
CMakeLists.txt的；若头文件在lib/headers/，就写target_include_directories(myapp PRIVATE lib/headers)，不要加./或../（CMake 自动按当前 CMakeLists.txt 位置解析）
特别注意：target_include_directories() 必须写在对应的 add_executable() 或 add_library() 之后，否则 target 名称未定义会报错。
子目录 CMakeLists.txt 怎么协同工作
大型项目必然拆分，但每个子目录的 CMakeLists.txt 不是独立存在的——它必须被父级显式调用。
- 在父
CMakeLists.txt中写add_subdirectory(src)，CLion 才会加载src/CMakeLists.txt - 子目录的
CMakeLists.txt里不能重复调用project()，也不能再设cmake_minimum_required() - 子目录中定义的
target_include_directories()默认只对本目录 target 生效；若需让上层 target 也能用其头文件，得用INTERFACE修饰，例如：target_include_directories(mylib INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}/include)
容易被忽略的一点：CLion 的 “Mark Directory as”（右键 → Mark as → Sources Root / Excluded）只影响 IDE 索引和代码导航，**完全不影响 CMake 构建过程**。它解决的是“为什么跳转不到定义”，而不是“为什么编译不过”。
