CMakeLists.txt最简有效写法是cmake_minimum_required(VERSION 3.10)、project(名称)、add_executable(目标 源文件)，三行构成骨架；需确保cmake版本≥3.10、文件名严格为CMakeLists.txt、构建目录与源码分离，并在build目录中执行cmake ..生成构建系统。
别从“学CMake”开始，直接从 cmake_minimum_required、project、add_executable 这三行写起——这三行能跑通，你就已经越过80%新手卡点。
第一次运行就失败？先盯住这三件事
绝大多数“CMake不工作”的问题，其实根本没走到编译阶段，而是卡在环境或路径上：
- 终端里执行
cmake --version，输出版本号必须 ≥ 3.10；低于这个值（比如 Ubuntu 默认的 3.10.2 以下旧包），set(CMAKE_CXX_STANDARD 17)会静默失效 -
CMakeLists.txt文件名必须全大写、无后缀、无空格——写成CMakeLists.txt.txt或cakelists.txt都不会被识别 - 构建目录不能和源码目录混在一起：必须
mkdir build && cd build && cmake ..，直接在源码根目录下运行cmake .容易污染项目，且后续清理困难
add_executable 为什么找不到 main.cpp？
不是路径写错了，而是 CMake 默认只认当前 cmake 命令所在目录的同级文件。它不会自动递归搜索子目录里的源码：
- 如果
main.cpp在src/子目录下，就得写成add_executable(app src/main.cpp) - 多个文件要显式列全：
add_executable(app src/main.cpp src/utils.cpp)，不能用通配符*.cpp - 头文件路径不用手动加——只要
#include "xxx.h"能被编译器找到，CMake 就默认信任你已处理好包含关系；真要控制头文件搜索路径，用target_include_directories(app PRIVATE include)
为什么改了 CMakeLists.txt 却不生效？
CMake 不是解释型脚本，它生成的是构建系统（如 Makefile），修改配置后必须重新运行 cmake ..，否则 make 仍按旧规则执行：
- 常见误操作：改完
CMakeLists.txt后只敲make，结果还是旧二进制——必须先cd build && cmake ..再make - 想快速重试？删掉整个
build/目录再重建最干净，比反复cmake ..更可靠 - 注意：
cmake ..输出里如果出现-- Configuring done但没报错，不代表成功；得看到-- Generating done和-- Build files have been written to:才算真正生成完毕
真正的难点不在语法，而在理解 CMake 是“生成构建系统”而非“直接编译”——它不碰代码逻辑，只管怎么把代码喂给编译器。一旦接受这个前提，所有奇怪行为（比如改了源码却不 rebuild）就都有了归因方向。
