cmake执行失败主因有四：未在含cmakelists.txt目录运行；add_executable路径错误或滥用glob；target_link_libraries混淆库名与文件名；构建目录污染致缓存错误。
cmake 命令执行失败：找不到 CMakeLists.txt
常见错误是直接在项目根目录外运行 cmake，或目录里压根没放 CMakeLists.txt。CMake 不会自动递归找配置文件，必须手动 cd 到含 CMakeLists.txt 的目录再执行。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 先确认当前路径下存在
CMakeLists.txt：ls -l CMakeLists.txt（Linux/macOS）或dir CMakeLists.txt（Windows） - 不要在源码子目录（比如
src/）里运行cmake ..却忘了上层没有CMakeLists.txt—— 主配置通常在项目最顶层 - 如果用 IDE（如 CLion、VS Code）自动生成，注意它可能把
CMakeLists.txt放在隐藏的构建目录里，不是你手写的那个
add_executable 中找不到源文件：路径写错或未 glob
add_executable 里的源文件路径是相对于 CMakeLists.txt 所在目录的，不是相对于当前 shell 路径。写错路径不会报错，但编译时提示 “no such file or directory” 或链接失败。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用相对路径，比如
add_executable(myapp src/main.cpp src/utils.cpp)，前提是src/在CMakeLists.txt同级 - 避免用
file(GLOB ...)自动收集源码 —— 它不触发增量重配置，新增 .cpp 文件后cmake不会自动感知，得手动删build/重来 - 如果源文件分散在多层目录，用
set_source_files_properties或target_sources显式管理，别依赖模糊匹配
target_link_libraries 链接失败：库名 vs 实际文件名混淆
链接时写 target_link_libraries(myapp pthread) 是对的，但写成 libpthread.so 或 pthread.a 就会失败 —— CMake 内部靠库名查系统路径和后缀，不是按文件名硬匹配。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 系统库（如
pthread、m、dl）直接写名字，不用前缀lib和后缀 - 第三方静态库（如
libfmt.a）推荐用find_package(fmt REQUIRED)+target_link_libraries(myapp fmt::fmt)，而不是手动指定路径 - 自己写的库，用
add_library(mylib STATIC mylib.cpp)定义后，再用target_link_libraries(myapp mylib)—— 这里也只写目标名，不写路径
构建目录污染导致 cmake 重复执行失败
很多人习惯把 build/ 目录建在源码树里，然后反复运行 cmake ..。一旦 CMakeCache.txt 或 CMakeFiles/ 残留旧配置，新修改（比如加了 set(CMAKE_CXX_STANDARD 20)）可能被忽略，还报奇怪的缓存冲突错误。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 始终用干净的构建目录：
mkdir build && cd build && cmake ..，别复用 - 不要手动编辑
CMakeCache.txt—— 改配置用命令行参数，比如cmake -DCMAKE_BUILD_TYPE=Release .. - CI 或脚本中，强制清理再构建：
rm -rf build && mkdir build && cd build && cmake .. && cmake --build .
最容易被忽略的是：CMake 的缓存机制不是“越用越聪明”，而是“越用越固执”。一次配置出错，后续所有构建都可能继承错误状态，除非彻底清掉构建目录。
