“no cmake_c_compiler could be found”错误源于cmake在构建目录中未探测到可用c/c++编译器，因其默认不自动回退查找path中的gcc或cl；需确认编译器存在、显式指定路径（如-dcmake_c_compiler）、匹配生成器（如-g "mingw makefiles"），并清除build目录以避免缓存干扰。
CMake 不是编译器，也不是构建工具本身，它只负责生成构建文件——你写错 CMakeLists.txt，再熟的 make 或 msbuild 都救不回来。
为什么 cmake .. 报错 “No CMAKE_C_COMPILER could be found”？
这不是环境没装好，而是 CMake 在构建目录里找不到可用的 C/C++ 编译器。它不会自动 fallback 到系统 PATH 里的 gcc 或 cl，尤其在干净的容器或新装系统中极易触发。
- 先确认编译器真实存在：
which gcc（Linux/macOS）或where cl.exe（Windows VS 开发者命令行） - 如果编译器在非标准路径，必须显式指定：
cmake -DCMAKE_C_COMPILER=/usr/bin/clang .. - Windows 上用 MinGW 而不是 MSVC？加参数：
cmake -G "MinGW Makefiles" ..，否则默认找 Visual Studio 工具链 - 首次运行
cmake ..后会缓存编译器路径到build/CMakeCache.txt；改换编译器时，必须删掉整个build/目录再重来，否则旧缓存会干扰
add_executable() 找不到源文件？路径问题比想象中更顽固
add_executable() 的第二个及后续参数是**相对于当前 CMakeLists.txt 所在目录的路径**，不是相对于构建目录，也不是相对于项目根目录——这点新手最容易栽跟头。
- 如果你的
CMakeLists.txt在src/下，而main.cpp在src/main.cpp，那就写add_executable(app main.cpp) - 如果
main.cpp在上层./main.cpp，就得写add_executable(app ../main.cpp)，不能写main.cpp - 多文件时别手动列一堆：
add_executable(app a.cpp b.cpp c.cpp)—— 改一个文件就要改 CMakeLists，推荐用file(GLOB SOURCES "*.cpp")（但注意：GLOB 不自动触发重新 configure，文件增删后需手动cmake .） - 头文件（
.h）不用传给add_executable()，但要用target_include_directories(app PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})告诉编译器去哪里找它们
为什么 set(CMAKE_CXX_STANDARD 17) 不生效？
这个 set 只影响后续定义的 target，对已存在的 target（比如之前调用过 add_executable()）完全无效——顺序错了就白设。
- 必须放在
add_executable()或add_library()之前，最好紧挨着project()后面 - 更稳妥的做法是直接设在 target 上：
set_property(TARGET app PROPERTY CXX_STANDARD 17)，这样哪怕 target 定义在前也管用 - 如果用了
target_compile_features(app PRIVATE cxx_std_17)，它不仅设标准，还会检查编译器是否真支持；而CMAKE_CXX_STANDARD只是“告诉编译器请按 17 标准跑”，不保底 - 混用 C 和 C++ 源码？别只设
CMAKE_CXX_STANDARD，C 部分得单独设CMAKE_C_STANDARD
静态库链接失败：undefined reference to `xxx` 怎么定位？
错误信息里那个 `xxx` 函数名，往往不是你写的，而是你依赖的静态库内部调用的、但没被拉进来的符号——根本原因通常是链接顺序或接口暴露不全。
- 静态库 A 依赖静态库 B，链接时必须保证 A 在 B 左边：
target_link_libraries(app A B)，反过来就会丢符号 - 用
add_library(mylib STATIC foo.cpp)创建库后，必须用target_include_directories(mylib PUBLIC include/)，否则使用者包含头文件时找不到声明 - 检查静态库是否真含目标符号：
nm -C libmylib.a | grep 'your_function_name'；如果输出为空，说明该函数根本没被编译进去（比如被#ifdef掉了） - Windows 下静态库后缀是
.lib，Linux/macOS 是.a，但target_link_libraries()不需要写后缀，CMake 会自动匹配；写死了反而跨平台失效
最常被忽略的一点：CMake 的 configure 阶段（cmake ..）和 build 阶段（make）是分离的。改了 CMakeLists.txt 之后，如果只跑 make，它根本不会重新解析配置——必须重新 cmake .. 或至少 cmake --build . 触发 configure 检查。
