CMakeLists.txt中cmake_minimum_required(VERSION 3.10)必须为第一行，project(MyApp CXX)紧随其后；源文件需用set(SOURCES...)定义后引用；头文件路径须用target_include_directories(MyApp PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include)指定。
cmake_minimum_required 和 project 必须放在最前面
这两条指令是 CMakeLists.txt 的启动开关，顺序不能错，否则 cmake 直接报错退出。常见错误是把 project 放在注释或空行之后——CMake 不吃这套，它只认紧贴文件开头的合法指令。
-
cmake_minimum_required(VERSION 3.10)必须是第一行，版本号写法严格：不能写成3.10.0或3.10.1（除非你真需要那个补丁版），3.10就够了 -
project(MyApp CXX)紧跟其后，语言参数推荐显式写上CXX，避免默认只启用 C 导致.cpp文件被忽略 - 别用
project(MyApp VERSION 1.0)后再手动设set(PROJECT_VERSION ...)——重复定义会覆盖，CMake 已自动设好PROJECT_VERSION变量
add_executable 怎么列源文件才不踩坑
源文件路径写错、漏文件、用错分隔符，是新手最常卡住的地方。CMake 不支持通配符自动收集（比如 *.cpp），也不接受相对路径里带 ../（除非用 ${CMAKE_CURRENT_SOURCE_DIR} 显式拼）。
- 推荐用
set(SOURCES main.cpp utils.cpp)先归组，再add_executable(MyApp ${SOURCES})——变量名大写小写要一致，SOURCES和sources是两个变量 - 多个文件用空格分隔，不要用逗号或分号；
add_executable(MyApp main.cpp, utils.cpp)会当成一个叫main.cpp,的文件，报 “file not found” - 如果源文件在子目录（如
src/），别直接写src/main.cpp，而要用${CMAKE_CURRENT_SOURCE_DIR}/src/main.cpp或先add_subdirectory(src)
target_include_directories 是头文件路径的唯一正解
老写法 include_directories(...) 是全局生效，容易污染其他 target；新写法 target_include_directories 绑定到具体目标，干净且可继承。
- 对可执行文件加头文件路径：
target_include_directories(MyApp PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include) -
PRIVATE表示只本 target 能用，PUBLIC表示本 target 及所有链接它的 target 都能用（适合库项目） - 别漏掉
${CMAKE_CURRENT_SOURCE_DIR}——直接写include/会让 CMake 在 build 目录下找，而不是源码目录 - 如果用了第三方库（如 Boost），用
find_package(Boost REQUIRED)后，再target_include_directories(MyApp PRIVATE ${Boost_INCLUDE_DIRS})
C++ 标准和编译器警告得靠 target_compile_features 或 set 控制
set(CMAKE_CXX_STANDARD 17) 是全局开关，但只影响后续 add_executable 和 add_library；真正决定能否用 std::optional 这类特性的是 target_compile_features。
- 全局设标准：
set(CMAKE_CXX_STANDARD 17)放在project()后面即可 - 精确控制特性支持：
target_compile_features(MyApp PRIVATE cxx_std_17 cxx_optional)，这样即使标准设为 14，也能单独启用optional - 警告选项按编译器区分：
if(MSVC)加/W4，else()加-Wall -Wextra，别一股脑全塞进set(CMAKE_CXX_FLAGS ...) - 别用
add_definitions(-DDEBUG)，改用target_compile_definitions(MyApp PRIVATE DEBUG)，作用域更清晰
add_subdirectory 和 find_package 的路径处理、跨平台库链接时的 target_link_libraries 作用域（PRIVATE/INTERFACE）、以及构建目录必须隔离（不能在源码根目录下 cmake .），才是最容易出问题的深水区。 
