add_executable后必须显式指定所有源文件，否则报“Cannot find source file”；路径相对CMakeLists.txt，需先定义目标再用target_link_libraries链接，且build目录须与源码分离。
add_executable 之后必须指定源文件
很多新手写完 add_executable(myapp) 就以为完事了，结果构建时报错：Cannot find source file。CMake 不会自动扫描 .cpp 或 .c 文件，必须显式列出——哪怕只有一份源码也要写全。
- 正确写法：
add_executable(myapp main.cpp utils.cpp) - 如果源文件分散在子目录，用相对路径：
add_executable(myapp src/main.cpp src/net/server.cpp) - 不支持通配符（
*.cpp）直接传给add_executable；如需批量收集，得先用file(GLOB ...)赋值给变量，再传入
target_link_libraries 必须放在 add_executable 之后
链接第三方库时顺序错了，会报 target 'myapp' not found 或链接失败。CMake 是声明式语法，target_link_libraries 的目标名必须是已定义的可执行目标。
- 错误顺序：
target_link_libraries(myapp pthread)在add_executable(myapp ...)前 - 正确顺序：先
add_executable(myapp main.cpp)，再target_link_libraries(myapp pthread) - 如果依赖的是 CMake 导出的库（比如
find_package(OpenCV REQUIRED)），链接时要用target_link_libraries(myapp ${OpenCV_LIBS})或更推荐的target_link_libraries(myapp opencv_core opencv_imgproc)
main() 函数必须在某个源文件里，且不能被条件编译掉
即使 add_executable 和 target_link_libraries 都写对了，若最终链接阶段找不到入口点，会报类似 undefined reference to `main' 的错误。常见于以下情况：
-
main.cpp被误加到if(NOT WIN32)里，导致 Windows 下没编译它 - 用了
#ifdef ENABLE_GUI把main()包裹起来，但构建时没定义该宏 - 源文件编码含 BOM 或用了非标准换行符，导致预处理器跳过
main()声明 - C++ 项目里混进了纯 C 的
main.c，但没设set_property(SOURCE main.c PROPERTY LANGUAGE C)，CMake 默认当 C++ 编译，可能引发符号名修饰问题
build 目录不能和源码目录混用
直接在源码根目录下运行 cmake .，容易污染源码树，还可能导致缓存残留、生成逻辑错乱，最典型的就是改了 add_executable 名称后仍生成旧的可执行文件。
- 始终用 out-of-source 构建：
mkdir build && cd build && cmake .. && make - 如果之前误用了 in-source 构建，删掉所有生成的
CMakeCache.txt、CMakeFiles/和中间文件再重来 -
make install前确认CMAKE_INSTALL_PREFIX是否设对；默认可能装到/usr/local/bin，普通用户没权限，建议临时设为-DCMAKE_INSTALL_PREFIX=$PWD/install
CMake 对“可执行文件”的理解非常机械：只要有一个 add_executable 命令、对应源码里有 main、链接能通过，就生成二进制。其余全是路径、顺序、作用域这些细节在捣鬼。
