find_package不是黑盒，需明确指定路径、版本、组件及模式：Config模式找XXXConfig.cmake（现代库首选），Module模式找FindXXX.cmake（兼容旧库）；大小写敏感、非标准路径需通过CMAKE_PREFIX_PATH或PATHS+NO_DEFAULT_PATH显式设置，且须验证OpenCV_FOUND与OpenCV_VERSION等变量。
find_package 不是“调用就能用”的黑盒，它依赖系统环境、CMake版本和包本身的配置方式。直接写 find_package(OpenCV) 很可能报错——不是找不到，而是没告诉 CMake 去哪找、找什么版本、要不要组件。
为什么 find_package 找不到已安装的库？
常见错误现象：Could NOT find XXX (missing: XXX_LIBRARIES XXX_INCLUDE_DIRS) 或 Found package configuration file but it set XXX_FOUND to FALSE。
- CMake 默认只查标准路径（如
/usr/lib/cmake/XXX/、/usr/local/lib/cmake/XXX/），自定义安装路径（比如/opt/opencv4）必须显式告知 - 包名大小写敏感：有些包提供
OpenCVConfig.cmake，但find_package(opencv)会失败，得写find_package(OpenCV) - 版本约束写法不对：
find_package(Boost 1.70 REQUIRED)要求Boost_VERSION≥ 1.70；若只装了 1.65，就会失败，哪怕库文件存在 - 组件未启用：
find_package(OpenCV REQUIRED COMPONENTS core imgproc)中漏掉实际需要的highgui，也会导致OpenCV_FOUND为 FALSE
find_package 的两种模式：Config 模式 vs. Module 模式
CMake 先尝试 Config 模式（找 XXXConfig.cmake 或 xxx-config.cmake），失败后才 fallback 到 Module 模式（查 FindXXX.cmake）。两者行为差异大：
- Config 模式由库作者提供，更可靠，但要求库安装时生成了 config 文件（如
cmake --install . --prefix /opt/mylib且项目用了install(EXPORT ...)） - Module 模式由 CMake 自带或用户自定义（放在
CMAKE_MODULE_PATH），灵活性高但容易过时或不兼容新版本 - 强制指定模式：
find_package(Protobuf CONFIG REQUIRED)禁用 Module 模式；find_package(Protobuf MODULE REQUIRED)禁用 Config 模式
怎么让 find_package 找到非标准路径下的库？
不能靠改 CMAKE_PREFIX_PATH 就万事大吉——得在 find_package 之前设置，且路径要指向“包含 lib/cmake/XXX/ 或 share/XXX/”的父目录。
- 正确写法：
set(CMAKE_PREFIX_PATH "/opt/opencv4;$ENV{HOME}/.local")，然后find_package(OpenCV REQUIRED) - 临时覆盖（命令行）：
cmake -DCMAKE_PREFIX_PATH=/opt/hdf5 ..，比在 CMakeLists.txt 里硬编码更灵活 - 对单个包指定路径：
find_package(OpenCV REQUIRED PATHS /opt/opencv4 NO_DEFAULT_PATH)，NO_DEFAULT_PATH关键——否则仍会搜系统路径，干扰判断
检查 find_package 是否真成功了，别只看有没有报错
即使 find_package 不报错，也可能只找到头文件没找到库，或版本不对。必须验证关键变量：
- 查
XXX_FOUND：比如if(OpenCV_FOUND)，不是if(OpenCV_FOUND STREQUAL "TRUE") - 查具体变量是否存在：
message(STATUS "OpenCV version: ${OpenCV_VERSION}")，空字符串说明 config 文件没导出版本 - 查链接目标：
target_link_libraries(myapp PRIVATE ${OpenCV_LIBS})会失败，应改用target_link_libraries(myapp PRIVATE OpenCV::opencv_core)（现代 CMake 推荐的 imported target 方式） - 调试用：
cmake -DOpenCV_DIR=/opt/opencv4/lib/cmake/opencv4 ..，直接指定 config 文件所在目录，绕过搜索逻辑
最常被忽略的是：很多第三方库（如 PCL、VTK）的 config 文件依赖其他库的变量已定义，顺序错了就连锁失败——find_package 的调用顺序本身就有隐含依赖。
