cmake不是编译器，只生成构建文件；必须在独立build目录中运行cmake ..，且CMakeLists.txt需含add_executable/add_library；链接须用target_link_libraries声明目标级依赖，头文件路径优先用target_include_directories绑定目标。
直接上手写 CMakeLists.txt 却编译失败？不是语法错，而是构建流程没走对——cmake 不是编译器，它只生成构建文件；真正编译靠 make 或 cmake --build。
为什么 cmake .. 后 make 报 “No targets specified”
这是最常卡住新手的第一步。根本原因：你没在源码目录外新建独立的 build 目录，或者 cmake .. 执行时当前路径不对。
-
cmake必须在空目录（推荐叫build）里运行，且参数必须指向含CMakeLists.txt的上层目录（即..） - 不能在项目根目录直接执行
cmake .—— 这会污染源码树，且某些生成器（如 Visual Studio）根本不支持 in-source build - 确认
CMakeLists.txt里至少有一条add_executable或add_library，否则 CMake 无目标可生成
add_executable 和 target_link_libraries 怎么配才不报 undefined reference
链接失败不是库没编译，而是依赖关系没声明清楚。CMake 的链接是目标级（target-level），不是文件级。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
add_executable(myapp main.cpp)只告诉 CMake “我要编一个叫 myapp 的程序”，但不包含任何链接信息 - 如果用到了
math.cpp里的函数，必须显式写target_link_libraries(myapp PRIVATE math)，且math必须是已定义的目标（比如通过add_library(math STATIC math.cpp)） -
PRIVATE表示仅myapp内部用到math；若myapp的头文件又暴露了math的类型，则需改用PUBLIC，否则下游包含myapp头文件时会找不到math.h
include_directories 不生效？优先用 target_include_directories
include_directories 是全局作用域命令，容易覆盖、难追踪；现代 CMake 推荐绑定到具体目标。
- 错误写法：
include_directories(./include)—— 它会让所有后续add_executable都加上这个路径，哪怕某个目标根本不需要 - 正确写法：
target_include_directories(myapp PRIVATE ./include)—— 只影响myapp，且PRIVATE表示不传递给依赖它的其他目标 - 如果库
math的头文件要被使用者包含，应在定义库时写：target_include_directories(math PUBLIC ./include)，这样target_link_libraries(myapp PRIVATE math)后，myapp自动获得./include路径
CMAKE_BUILD_TYPE=Debug 不起作用？检查生成器和缓存
-DCMAKE_BUILD_TYPE=Debug 只对 Makefile 生成器有效；Ninja 或 Visual Studio 生成器默认忽略该变量。
- Linux 下用 Makefile：执行
cmake -Bbuild -DCMAKE_BUILD_TYPE=Debug，然后cmake --build build - 如果之前已在
build目录运行过cmake，再改CMAKE_BUILD_TYPE必须清缓存或删掉build/CMakeCache.txt，否则旧值仍生效 - 想让所有生成器都支持调试/发布切换，应配合
set(CMAKE_CXX_FLAGS_DEBUG "-g")等手动设置，或使用if(CMAKE_BUILD_TYPE STREQUAL "Debug")条件块
最容易被忽略的是作用域问题：子目录 CMakeLists.txt 里定义的变量、目标，默认不会自动传给父目录或兄弟目录；add_subdirectory 是单向引入，不是继承。多模块项目务必把依赖关系显式写在 target_link_libraries 和 target_include_directories 里，别指望“全局 include”能兜底。
