cmake_minimum_required必须为首行，project紧随其后，顺序错误会导致解析失败；二者均不可前置空行或注释，且cmake_minimum_required(VERSION 3.10)是兼容现代C++特性的安全底线。
cmake_minimum_required 和 project 必须放在最前面
这两行是 CMakeLists.txt 的“硬性开头”，顺序不能错，否则 cmake .. 会直接报错：Parse error in command line 或提示 project() must be called before add_executable()。
-
cmake_minimum_required(VERSION 3.10)是安全底线——低于 3.10 的 CMake 无法识别LANGUAGES CXX等现代写法，CI 环境里常见旧版（如 Ubuntu 18.04 自带 3.10.2），设成 3.10 覆盖面最稳 -
project(HelloWorld LANGUAGES CXX)必须紧随其后；LANGUAGES CXX显式声明只用 C++，避免 CMake 自动启用 C 编译器导致奇怪警告；不写版本号也行，但加上VERSION 1.0对后续打包或 install 有帮助 - 别在它们前面加空行或注释——CMake 解析器对头部空白敏感，某些旧版本会把首行注释当无效指令跳过，导致 project 指令变成实际第一行而报错
add_executable 的源文件路径必须相对项目根目录
如果你的 main.cpp 放在 src/main.cpp，那 add_executable 里就得写 src/main.cpp，而不是 ./src/main.cpp 或 ../src/main.cpp——CMake 所有路径都以 CMakeLists.txt 所在目录为基准。
- 错误写法：
add_executable(hello ./src/main.cpp)→ 报错file not found - 正确写法：
add_executable(hello src/main.cpp)，哪怕你在build/目录下运行cmake ..，CMake 也自动从上层找src/main.cpp - 多个源文件直接空格并列：
add_executable(hello src/main.cpp src/utils.cpp)；用变量反而容易出错，比如set(SOURCES src/main.cpp)后漏写${SOURCES}大括号，就变成字面量字符串
构建时一定要用 out-of-source 方式，别在源码目录里 cmake
直接在项目根目录执行 cmake . 会把所有中间文件（CMakeCache.txt、CMakeFiles/、Makefile）全塞进源码树，Git 提交时极易误提交，清理也麻烦。标准做法是建个独立 build 目录。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 正确流程：
mkdir build && cd build && cmake .. && make注意最后是cmake ..（两个点），不是cmake . - 如果已经误操作了，删掉根目录下所有自动生成的文件比修复更省事：
rm -rf CMakeCache.txt CMakeFiles/ Makefile cmake_install.cmake - Windows 用户用 PowerShell 时，
mkdir build; cd build; cmake ..中的分号不是必须的，但换行执行更稳妥；别用cmake -G "Visual Studio 17 2022"这类生成器参数起步——先跑通 Make/Ninja 再扩展
编译失败时优先检查 C++ 标准和编译器能否识别
即使 main.cpp 只有一行 std::cout，也可能因 C++ 标准太低被拒——比如默认用 C++98，而 std::endl 在某些老编译器下需要显式 #include <iostream> 且 C++11 才完全稳定。
- 加一行
set(CMAKE_CXX_STANDARD 17)和set(CMAKE_CXX_STANDARD_REQUIRED ON)能堵住大多数“找不到 std::”类报错 - 如果
cmake ..阶段就报The CXX compiler identification is unknown，说明没装 g++/clang++，或者 PATH 里没有；Linux 上装build-essential，macOS 装 Xcode Command Line Tools，Windows 装 Visual Studio Build Tools -
make报错里出现undefined reference to `std::cout'，基本是链接阶段问题，大概率因为add_executable没包含所有源文件，或用了extern "C"但没配好符号导出
真正卡住的地方往往不是语法，而是路径、目录结构和环境状态这三块——CMake 不报具体哪行错，只甩一句 “Configuring incomplete”，得靠 cmake .. 输出里那几行 -- The CXX compiler identification is ... 判断编译器有没有被识别到，再看 build/CMakeFiles/CMakeOutput.log 里的真实错误。
