应设 cmake_minimum_required(VERSION 3.10 起)，避免旧版语法被新 CMake 拒绝；add_executable 必须显式列出所有 .cpp 文件，GLOB 需手动刷新缓存；头文件路径应用 target_include_directories 绑定 target；修改 CMakeLists.txt 后必须重新运行 cmake .. 再构建。
cmake_minimum_required 版本设太低会报错
很多新手直接抄网上旧教程，写 cmake_minimum_required(VERSION 2.8)，结果在现代 CMake（比如 3.20+）下跑 add_compile_options 或 target_compile_features 时突然失败——不是语法错，而是 CMake 自己拒绝解析。CMake 在较新版本里对旧语法做了静默弃用或严格校验。
- 当前稳妥起点是
cmake_minimum_required(VERSION 3.10)，覆盖 Ubuntu 20.04+/macOS Homebrew 默认版本 - 若用
target_compile_features（比如要 C++17std::optional），至少得VERSION 3.12 - 别硬套项目里别人写的版本号；运行
cmake --version看你本地实际版本，往上取整到最近的 LTS 小版本（如 3.16、3.22）更安全
add_executable 里漏掉 .cpp 文件就链接失败
常见现象：编译通过，但链接时报 undefined reference to `xxx`，尤其函数定义在 utils.cpp 里，而 CMakeLists.txt 只写了 add_executable(main main.cpp)。CMake 不自动扫描目录，它只认你显式列出来的源文件。
- 必须把所有参与构建的
.cpp都列进add_executable或add_library，例如：add_executable(myapp main.cpp utils.cpp logger.cpp) - 想避免手写一长串？用
file(GLOB SOURCES "*.cpp")，但注意：GLOB 不会自动触发重新配置，改了文件名或增删文件后得手动删build/下的缓存再cmake .. - 不推荐
GLOB_RECURSE深层扫描——容易误包测试文件或第三方代码，显式列举反而更可控
include_directories 和 target_include_directories 的区别
老写法 include_directories(./include) 看似能编译过，但会导致所有 target 共享头路径，污染依赖关系。一旦工程变大，A 库用了 B 库的头但没声明依赖，编译可能侥幸成功，换机器或清理构建就崩。
- 正确做法是绑定到具体 target：
target_include_directories(myapp PRIVATE ./include) -
PRIVATE表示只本 target 编译时用；PUBLIC表示本 target 用 + 依赖它的其他 target 也能用（适合库的头暴露）；INTERFACE表示只给依赖者用（纯头文件库） - 路径尽量用相对
CMAKE_CURRENT_SOURCE_DIR，别写绝对路径；./include比../include更易维护
生成 Makefile 后修改 CMakeLists.txt 必须重新 cmake
很多人改完 CMakeLists.txt 直接 make，发现新加的 target_compile_options 没生效，或者 find_package 找不到库——因为 make 只执行构建，不重读 CMake 配置。
立即学习“C++免费学习笔记（深入）”；
- 每次改
CMakeLists.txt后，进build/目录运行cmake ..（或cmake -G "Unix Makefiles" ..），再make - 如果只是改了源码，不用重 cmake；但只要动了构建逻辑（target 名、include 路径、link 库、编译选项），就得重来
- 用 Ninja 生成器（
cmake -G Ninja ..）比 Makefile 快，且 Ninja 本身会检查 CMakeCache.txt 是否过期，但依然不能跳过cmake ..这步
