CMake不是编译器或构建工具，而是生成构建文件的元构建系统；常见问题包括默认generator不匹配、源文件路径错误、全局include污染、缓存未更新及版本声明影响语法行为。
直接说结论：CMake 不是编译器，也不是构建工具本身，它只负责读 CMakeLists.txt，生成 Makefile、VS 工程或 Ninja 文件——你真正调用的还是 make、msbuild 或 ninja。
为什么 cmake .. 之后没生成 Makefile？
常见错误现象：在 build/ 目录下执行 cmake ..，终端输出一堆信息但没看到 Makefile，接着运行 make 报错 “No targets specified and no makefile found”。
- 根本原因：CMake 默认使用的是 generator，不是所有平台都默认选
Unix Makefiles；Windows 上装了 VS 后，cmake ..默认会生成 Visual Studio 工程（.sln），而不是 Makefile - 解决办法：显式指定 generator，例如 Linux/macOS 下用
cmake -G "Unix Makefiles" ..，Windows 下想用 MinGW 就得写cmake -G "MinGW Makefiles" .. - 验证方式：执行
cmake -S . -B build --help可列出当前系统支持的所有 generator - 注意：
-G参数必须放在..之前，写成cmake .. -G "Unix Makefiles"会被忽略
add_executable() 为什么找不到源文件？
典型报错：CMake Error at CMakeLists.txt:5 (add_executable): Cannot find source file ...
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 路径是相对于
CMakeLists.txt所在目录的，不是相对于当前 shell 路径或build/目录 - 比如项目结构是
src/main.cpp，而CMakeLists.txt在项目根目录，则必须写add_executable(app src/main.cpp)，不能写add_executable(app main.cpp) - 如果源文件名含空格或特殊字符（如
my file.cpp），CMake 会静默失败，建议重命名避免 -
add_executable()不支持通配符（如*.cpp），要用file(GLOB ...)显式收集，但不推荐用于生产——文件增删时 CMake 不会自动 reconfigure
target_include_directories() 和 include_directories() 哪个该用？
旧教程常写 include_directories(./include)，但它作用于全局，容易污染其他 target；现代 CMake（3.10+）强烈推荐前者。
-
include_directories()：影响后续所有add_executable()/add_library()，哪怕它们根本不需要这些头路径 -
target_include_directories(app PRIVATE ./include)：只让app这个 target 知道./include，且PRIVATE表示不传递给依赖它的其他 target - 三种作用域关键字：
PUBLIC（本 target 用 + 对接 target 可见）、INTERFACE（只对接口可见，本 target 不用）、PRIVATE（仅本 target 内部用） - 头文件路径尽量用相对路径，避免硬编码绝对路径（如
/usr/local/include），否则跨机器迁移会挂
为什么改了 CMakeLists.txt 重新 cmake .. 却没生效？
现象：修改了 set(CMAKE_CXX_STANDARD 17)，再跑一遍 cmake ..，但编译时仍报 C++11 错误。
- CMake 缓存机制导致：配置阶段生成的
CMakeCache.txt会记住旧值，cmake ..默认复用缓存，不会覆盖已存在的变量 - 正确做法：删掉整个
build/目录重建，或进build/后执行cmake -U -S .. -B .（-U清缓存） - 开发中建议始终用外部构建（
mkdir build && cd build && cmake ..），避免污染源码目录；内部构建（直接在源码目录cmake .）几乎没人用，也不推荐 - 注意：
cmake ..不等于重新编译，它只是重新生成构建文件；真正触发编译要靠cmake --build .或make
最易被忽略的一点：CMake 版本声明不是摆设。cmake_minimum_required(VERSION 3.10) 不仅限制最低版本，还决定语法行为——比如 target_compile_features() 在 3.1 可用，但只有 3.8+ 才支持 PRIVATE 关键字。写高版本号省下的调试时间，远多于查兼容性文档的时间。
