CMake 的 find_package 默认只在固定路径（如/usr/lib/cmake/、CMAKE_PREFIX_PATH）查找 *Config.cmake 文件，不搜索系统任意路径；若库无 config 文件，需手动创建 imported target 或用 find_path/find_library 定位后通过 add_library(... IMPORTED) 和 target_link_libraries 显式链接。
find_package 找不到库，是不是路径没加对？
不是路径没加对，是 CMake 默认根本不查你系统里随便放的库。它只在几个固定位置找，比如 /usr/lib/cmake/、/usr/local/lib/cmake/、CMAKE_PREFIX_PATH 指向的目录下带 FooConfig.cmake 或 FindFoo.cmake 的文件。
常见错误现象：find_package(OpenCV REQUIRED) 报错 “Could not find configuration file for package ‘OpenCV’”，但 pkg-config --modversion opencv4 能输出版本——说明库装了，CMake 就是没看见。
- 先确认目标库是否提供 CMake config 模式：检查安装目录下有没有
*Config.cmake或*-config.cmake（比如yaml-cpp-config.cmake） - 如果只有
FindXXX.cmake（老式模块模式），得确保它在CMAKE_MODULE_PATH里，或自己写一个并list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake") - 用
cmake -DCMAKE_PREFIX_PATH=/opt/mylib ..显式告诉 CMake 去哪翻，比改系统环境变量更可靠 - 别依赖
PATH或LD_LIBRARY_PATH，CMake 不看这些
target_link_libraries 链错了 target，链接时 undefined reference
现代 CMake 要求「链接谁、链什么」必须精确到 target，而不是全局 link_libraries()。错链、漏链、顺序反了都会导致符号找不到，尤其跨 target 依赖时。
典型场景：你写了 add_executable(app main.cpp)，又 find_package(fmt REQUIRED)，但没把 fmt::fmt 加进 target_link_libraries(app ...)，编译能过，链接炸。
立即学习“C++免费学习笔记（深入）”；
-
find_package只是“发现”库，不自动链接；必须显式调用target_link_libraries(my_target PRIVATE fmt::fmt) - 注意
PUBLIC/PRIVATE/INTERFACE：头文件在PUBLIC或INTERFACE里才透给依赖者；实现链接只放PRIVATE或PUBLIC - 不要写
target_link_libraries(app ${fmt_LIBRARIES})—— 这是旧写法，丢掉了 imported target 的属性（如 include dirs、compile definitions） - 用
message(STATUS "fmt_FOUND=${fmt_FOUND}, fmt_VERSION=${fmt_VERSION}")在find_package后立刻验证是否真找到了
第三方库没装 config 文件，又不想手写 FindXXX.cmake 怎么办？
很多 C++ 库（比如较老的 spdlog、某些自建库）只提供头文件 + 编译好的 .a/.so，没配 xxx-config.cmake。这时候不能硬等，得自己建 imported target 补上断点。
核心思路：跳过 find_package 的自动查找，手动构造一个符合 CMake 约定的 imported target，后续仍可用 target_link_libraries(... PRIVATE MyLib::core)。
- 用
find_path和find_library手动定位头文件和库文件，例如：find_path(SPDLOG_INCLUDE_DIR NAMES spdlog/spdlog.h) - 用
add_library(spdlog INTERFACE)创建 interface target，再target_include_directories(spdlog INTERFACE ${SPDLOG_INCLUDE_DIR}) - 如果库有 .so/.a，用
add_library(spdlog SHARED IMPORTED)+set_property(TARGET spdlog PROPERTY IMPORTED_LOCATION ...) - 最后
add_library(SPDLOG::spdlog ALIAS spdlog)，统一命名风格，和其他 config 模式库保持一致
Windows 下 find_package 找 Boost 失败，是大小写还是路径分隔符问题？
都不是。Boost 的 CMake 支持本身就不稳定，尤其在 Windows 上用 MSVC 时，find_package(Boost REQUIRED COMPONENTS system filesystem) 经常卡在找不到 boost_system-vc143-mt-x64-1_83.lib 这种带编译器/ABI 后缀的文件名。
根本原因是 Boost 官方 config 模式支持弱，多数用户实际走的是模块模式（FindBoost.cmake），而它严重依赖 BOOST_ROOT 和 Boost_COMPILER、Boost_ARCHITECTURE 等变量对齐。
- 显式设置
-DBOOST_ROOT=C:/local/boost_1_83_0，且确保该路径下有lib和include/boost - 加上
-DBoost_COMPILER=-vc143 -DBoost_ARCHITECTURE=-x64（根据你的 VS 版本和平台调整） - 避免混用静态/动态链接：Boost 库名后缀含
mt（多线程）、gd（debug）、dll（动态），要和你的项目配置严格匹配 - 实在不行，直接用 vcpkg：它会生成标准的
boost-config.cmake，且自动处理 ABI 对齐
最麻烦的其实是隐式依赖传递——比如你链了 boost_filesystem，但它内部又依赖 boost_system，而 CMake 默认不自动推导这种 transitive link。得手动补全所有 component，或者用 find_package(Boost REQUIRED COMPONENTS filesystem system) 写全。
