find_package 找不到库主因是未定位到配置文件（xxxconfig.cmake 或 findxxx.cmake），而非库未安装；cmake 仅搜索固定路径及 cmake_prefix_path 指定路径，需确认库是否提供 cmake 支持、正确设置路径并区分 config/module 模式。
find_package 为什么找不到我的库？
绝大多数问题出在 find_package 没法定位到目标库的配置文件（比如 xxxConfig.cmake 或 Findxxx.cmake），而不是库本身没装。CMake 不会自动扫描系统路径，它只查几个固定位置 + 用户显式指定的路径。
- 先确认库是否真的提供了 CMake 支持：运行
pkg-config --modversion xxx成功 ≠ 有xxxConfig.cmake；很多老库只带Findxxx.cmake，且不一定随包一起安装 - 检查
CMAKE_PREFIX_PATH是否包含库的安装根目录（比如/usr/local、/opt/homebrew）；macOS 上 Homebrew 安装的库常需手动加-DCMAKE_PREFIX_PATH=/opt/homebrew - 用
find_package(xxx REQUIRED NO_MODULE)强制只找 Config 模式，能快速判断是路径问题还是根本没 Config 文件
find_package 的两种模式怎么选？
find_package 默认先尝试 Config 模式（找 xxxConfig.cmake），失败再 fallback 到 Module 模式（找 Findxxx.cmake）。但行为受参数控制，容易混淆。
-
find_package(OpenCV REQUIRED)：先找OpenCVConfig.cmake，找不到再找FindOpenCV.cmake -
find_package(OpenCV REQUIRED CONFIG)：只走 Config 模式，找不到直接报错 —— 适合你明确知道库提供 Config 文件时，避免误用过时的 Find 模块 -
find_package(OpenCV REQUIRED MODULE)：只走 Module 模式，跳过 Config 查找 —— 适合嵌入式环境或自定义Findxxx.cmake时 - 注意大小写：
find_package(protobuf REQUIRED)和find_package(Protobuf REQUIRED)可能对应不同模块，取决于实际提供的文件名
怎么让 find_package 找到自定义路径下的库？
不能靠改系统环境变量，CMake 不读 LD_LIBRARY_PATH 或 PKG_CONFIG_PATH。必须通过 CMake 变量或命令行传入。
- 编译时指定：
cmake -DCMAKE_PREFIX_PATH=/path/to/mylib/build ..—— 这是最推荐的方式，清晰可复现 - 在
CMakeLists.txt中提前设置：set(CMAKE_PREFIX_PATH "/path/to/mylib" ${CMAKE_PREFIX_PATH})，但要放在find_package之前 - 用
HINTS参数临时指定路径：find_package(Boost REQUIRED HINTS /path/to/boost)，仅对本次查找生效，不污染全局 - 避免用
PATHS硬编码绝对路径，会导致别人无法构建；HINTS更安全
find_package 后怎么用找到的库？
找到只是第一步，后续链接和包含头文件得靠它导出的 target 或变量。直接用 INCLUDE_DIRECTORIES 或 target_link_libraries(myapp ${Boost_LIBRARIES}) 是过时写法，容易漏依赖或版本错乱。
- 现代写法（推荐）：
find_package(Threads REQUIRED)后用target_link_libraries(myapp Threads::Threads)——Threads::Threads是 IMPORTED target，自动处理接口头文件、链接选项、可见性 - 旧库可能只导出变量，如
OpenCV_INCLUDE_DIRS和OpenCV_LIBS，这时仍要手动target_include_directories和target_link_libraries，但注意变量名因库而异（OpenCV_INCLUDE_DIRSvsOpenCV_INCLUDE_DIR） - 检查是否成功：加
message(STATUS "OpenCV_FOUND = ${OpenCV_FOUND}")，别只信REQUIRED不报错就以为万事大吉
find_package 行为高度依赖库作者提供的 CMake 配置质量，同一库在不同发行版上可能一个带 Config 一个只带 Find 模块，甚至变量名都不统一。遇到问题先看 find_package 调用后输出的详细日志（加 -Wdev 或 --debug-find），比猜更有效。
