CMake 不是编译器或构建工具，而是跨平台构建系统生成器；它通过读取 CMakeLists.txt 生成 Makefile、Visual Studio 工程等，真正编译由 make/Ninja/MSBuild 执行。
直接说结论：CMake 不是编译器，也不是构建工具本身，它只负责读 CMakeLists.txt 生成适合当前平台的构建文件（比如 Linux 的 Makefile、Windows 的 Visual Studio 工程）。你真正要跑通的第一个项目，只需要三行配置、两个命令、一个构建目录 —— 其他都是可选的干扰项。
cmake .. 为什么总在 build 目录里执行？
因为 CMake 强烈推荐「外部构建」（out-of-source build），即源码目录和构建产物完全分离。否则 cmake . 会把 CMakeCache.txt、CMakeFiles/ 等中间文件全塞进源码根目录，污染 git、干扰 IDE、还容易误删。
-
mkdir build && cd build是标准起点，不是可选项 -
cmake ..表示“从上一级目录读CMakeLists.txt”，路径必须写对；用cmake -S .. -B .更显式，但效果一样 - 如果执行后报错
Could not find a package configuration file，说明依赖缺失，不是路径问题 - Windows 上用 VS 生成器时，
cmake -G "Visual Studio 17 2022" ..才能生成 .sln，光靠cmake ..默认走 Ninja 或 Make
add_executable() 参数顺序写反了会怎样？
add_executable() 第一个参数是目标名（最终生成的可执行文件名），第二个及之后是源文件路径 —— 这个顺序不能颠倒。写成 add_executable(main.cpp main) 不会报语法错误，但会导致 CMake 把 main.cpp 当作目标名，然后找不到名为 main 的源文件，最终构建失败，错误信息通常是：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
Cannot specify source files for target "main.cpp" which is not built by this project.
- 目标名可以任意取（比如
add_executable(myapp src/main.cpp)），但不要和源文件名相同，易混淆 - 源文件路径是相对于
CMakeLists.txt所在目录的，src/main.cpp和./src/main.cpp等价，但../src/main.cpp可能越界 - 多个源文件直接空格分隔：
add_executable(app main.cpp util.cpp logger.cpp)
cmake_minimum_required(VERSION x.y) 设太低会出什么问题？
设成 VERSION 2.8 或 3.0 看似兼容老项目，但现代写法（比如 target_include_directories()、find_package(... CONFIG)）在旧版本里根本不存在，CMake 会直接报错退出，提示：
Unknown CMake command "target_include_directories".
- 当前（2026 年）安全下限是
VERSION 3.10，绝大多数发行版和 CI 环境都支持 - 如果你用
FetchContent或install(EXPORT)，建议直接写VERSION 3.15或更高 - 版本号不是“越高越好”：设成
3.30而 CI 机器只有3.18，照样失败 —— 查清最低可用版本再定
project() 里不写 LANGUAGES 会怎样？
默认行为是同时启用 C 和 CXX，但如果你只写 C++ 代码却没声明语言，CMake 可能用 C 编译器去处理 .cpp 文件，导致 std::cout 等符号找不到，链接时报错：
undefined reference to `std::cout'
- 明确写
project(MyApp LANGUAGES CXX)，CMake 就只初始化 C++ 工具链，自动选g++或clang++ - 混合语言项目才需要列全：
LANGUAGES C CXX ASM -
project()必须紧跟cmake_minimum_required()，且只能出现一次，重复定义会覆盖前值
最容易被忽略的其实是缓存机制：cmake .. 第二次运行时不会重新检测编译器或重读 option()，它直接复用 CMakeCache.txt 里的值。改了 CMAKE_CXX_STANDARD 却没生效？先删掉整个 build/ 目录再试。
