正确组织多目录CMakeLists.txt：根目录仅声明版本、项目名并add_subdirectory()引入子目录；各子目录独立定义target，用PUBLIC指定头路径与依赖传递，跨目录链接须显式target_link_libraries()。
如何组织多目录源码的CMakeLists.txt结构
CMake在大型项目里最常崩在目录嵌套混乱——不是找不到源文件，而是add_subdirectory()顺序错、target_include_directories()作用域没理清。根目录CMakeLists.txt只做三件事：声明最低版本、项目名、递归引入子目录；每个子模块自己负责定义add_library()或add_executable()，不向上暴露内部路径。
常见错误现象：include could not find load file: XXXConfig.cmake，本质是子目录提前用了未定义的target；或者undefined reference，其实是链接时target没传进target_link_libraries()。
- 根
CMakeLists.txt里用add_subdirectory(src)、add_subdirectory(third_party)，别写逻辑 - 子目录中用
target_include_directories(mylib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)，PUBLIC才让下游能继承头路径 - 跨目录依赖必须显式写
target_link_libraries(app PRIVATE mylib)，不能靠include_directories()全局污染 - 避免在子目录里调用
project()——CMake只允许一次，否则报project PROJECT is invoked multiple times
怎样正确管理第三方依赖（非conan/vcpkg场景）
不用包管理器时，最容易踩的坑是把find_package(OpenSSL REQUIRED)当万能钥匙——它只查系统路径和CMAKE_PREFIX_PATH，不会自动下载或编译。真要跨平台，得自己控制源码构建流程。
使用场景：团队内统一用特定OpenSSL版本，或某库无系统包（如定制版protobuf）。
立即学习“C++免费学习笔记（深入）”；
- 用
add_subdirectory(third_party/openssl)把源码拉进来，前提是对方有CMakeLists.txt - 若没有CMake支持，改用
ExternalProject_Add()，但注意它默认在build阶段才拉代码，IDE可能无法索引头文件 -
find_package()失败后别硬写include_directories(/usr/local/opt/openssl/include)——macOS Homebrew路径和Linux不同，会破坏可移植性 - 所有第三方target加
set_property(TARGET openssl PROPERTY IMPORTED_GLOBAL TRUE)，否则跨子目录引用会报target was not found
Windows/Linux/macOS下编译选项怎么差异化处理
CMake的if(WIN32)、if(APPLE)、if(UNIX AND NOT APPLE)不是装饰品，漏掉会导致链接失败或运行时崩溃。比如Windows默认用/MD，Linux用-fPIC，但set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fPIC")直接写死会污染Windows构建。
- 用
target_compile_options(mylib PRIVATE $:/W4> $:-Wall>)，条件表达式更安全 - 动态库导出宏必须匹配：Windows加
target_compile_definitions(mylib PRIVATE MYLIB_EXPORTS)，Linux/macOS不用 - RTTI和异常开关（
-fno-rtti、-fno-exceptions）要全项目统一，否则std::string跨DLL传递会core dump - macOS上
-undefined dynamic_lookup慎用——它掩盖符号缺失，上线后dlopen失败才暴露
为什么生成的Visual Studio工程里找不到头文件索引
VS生成器（cmake -G "Visual Studio 17 2022"）默认不把target_include_directories()里的路径加进IntelliSense，只用于编译。结果就是编辑器标红，但cmake --build能过。
- 确保用
PUBLIC或INTERFACE而非PRIVATE修饰头路径，否则下游target看不到 - VS里打开
项目属性 → 配置属性 → 常规 → 继承的值，确认$(IncludePath)包含你的路径 - 如果用Clang-Cl工具链，需额外加
set(CMAKE_CXX_CLANG_TIDY "clang-tidy")并配置compile_commands.json - 别信IDE缓存——删掉
build/整个目录再cmake ..，否则旧的vcxproj文件可能残留错误路径
跨平台CMake最难的从来不是语法，而是每个target_*命令背后的作用域规则和生成器差异。写完一个add_library()，立刻问自己：这个target的头路径、宏定义、链接库，哪些会被下游看到？漏掉PUBLIC或写错PRIVATE，问题要到链接或运行时才爆发。
