最小可用cmakelists.txt必须显式声明三要素：cmake_minimum_required(version 3.10)、project(myapp)、add_executable(myapp src/main.cpp)；需配合独立build目录、正确编译器路径及清理缓存，否则cmake ..易报错或生成错误makefile。
Linux上CMake配置不是“装完就能用”，关键在于 CMakeLists.txt 写对、构建目录选对、编译器路径理清——漏掉任一环节，cmake .. 就会报错或生成错误的 Makefile。
怎么写最小可用的 CMakeLists.txt
它不是模板填充游戏，而是三要素必须显式声明：最低版本、项目名、目标生成规则。常见错误是照抄网上例子却忽略版本兼容性或源文件路径错误。
-
cmake_minimum_required(VERSION 3.10)—— Ubuntu 22.04+ 默认带 3.22，但老系统（如 CentOS 7）只有 2.8.12，硬写3.10会直接失败；建议按实际环境写3.5或查cmake --version后取整 -
project(myapp)—— 名字不能含空格或特殊字符，否则后续add_executable可能静默失败 -
add_executable(myapp src/main.cpp)—— 路径必须真实存在；如果写成add_executable(myapp main.cpp)但main.cpp在src/下，cmake不报错但make时提示No rule to make target 'main.cpp'
为什么一定要用独立 build 目录？
直接在源码根目录执行 cmake . 看似省事，实则污染源树：生成的 CMakeCache.txt、CMakeFiles/、Makefile 全混在代码里，git 忽略难写全，清理靠手动 rm -rf CMake* 容易误删。
- 正确做法：
mkdir build && cd build && cmake ..——..指向含CMakeLists.txt的源码目录 - 若想指定输出位置（比如统一放到
bin/），在CMakeLists.txt加一行：set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin) - VS Code + CMake Tools 插件默认就建
build/，别手贱删了它再cmake .
编译器没被识别？先查 CC 和 CXX 环境变量
cmake 默认找 gcc 和 g++，但如果你装了 clang 或交叉工具链，不显式指定就会 fallback 到系统默认（可能版本太旧或根本没装）。
- 临时指定：
cmake -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ .. - 永久生效：在
CMakeLists.txt开头加set(CMAKE_C_COMPILER clang)和set(CMAKE_CXX_COMPILER clang++)（注意顺序，必须在project()之后） - 验证是否生效：运行
cmake ..后看终端输出第一行，类似-- The C compiler identification is Clang 18.1.3才算成功 - 常见坑：
export CC=clang对cmake无效 —— 它只读CMAKE_C_COMPILER，不读环境变量
target_link_libraries 链接失败的典型表现
写完 add_executable 后加 target_link_libraries(myapp pthread) 却报 undefined reference to 'pthread_create'，不是库名写错，而是链接时机或作用域问题。
- 必须放在
add_executable之后，否则myapp目标还不存在，target_link_libraries无处绑定 - 系统库（如
pthread、m）直接写名字即可；第三方库（如muduo）需先用find_package(muduo REQUIRED)或link_directories(/path/to/lib) - 静态库链接要写全名：
target_link_libraries(myapp /usr/local/lib/libfoo.a)；动态库优先用-lfoo形式，靠link_directories或find_library定位 - 调试技巧：
make VERBOSE=1查看最终传给gcc的完整命令行，确认-lpthread是否真的出现在链接参数里
真正卡住人的往往不是语法，而是 cmake 缓存残留 —— 改了 CMakeLists.txt 但没删 build/CMakeCache.txt，旧配置还在生效；或者 find_package 找到的是旧版本库，却以为是新版本接口。动手前先 rm -rf build/*，比反复猜错因更省时间。
