根本原因是CMAKE_PREFIX_PATH未正确指向包含lib/cmake/xxx/的安装前缀目录，或库未执行install生成OpenCVConfig.cmake等标准配置文件；CMake默认不扫描任意路径，仅查找系统路径及CMAKE_INSTALL_PREFIX。
find_package 为什么找不到本地库？
根本原因通常是 CMAKE_PREFIX_PATH 没设对，或者库没按 CMake 期望的目录结构安装。CMake 默认只查系统路径（如 /usr、/usr/local）和 CMAKE_INSTALL_PREFIX，不会自动扫描你随便放的 lib/ 或 build/ 目录。
常见错误现象：find_package(OpenCV REQUIRED) 报错 Could not find OpenCV，但明明你本地编译好了 OpenCV 放在 /home/user/opencv-4.8.1/install 下。
- 确认库是否已正确安装（不是只 build 了没 install）：检查目标路径下是否有
lib/cmake/opencv4/（或share/opencv4/）子目录，里面要有OpenCVConfig.cmake或OpenCVConfigVersion.cmake -
CMAKE_PREFIX_PATH必须指向「包含lib/cmake/xxx/的父目录」，不是直接指向lib/cmake/xxx/ - 如果库是用
cmake .. -DCMAKE_INSTALL_PREFIX=/path/to/install && make install安装的，就用那个/path/to/install路径
三种指定本地路径的写法及适用场景
优先级从高到低：命令行 > CMakeLists.txt > 环境变量。推荐命令行方式，最干净、可复现。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 命令行传参（最常用）：
cmake -DCMAKE_PREFIX_PATH=/home/user/opencv-4.8.1/install ..
注意：多个路径用分号分隔（Linux/macOS 也要用分号，不是冒号），例如-DCMAKE_PREFIX_PATH="/opt/mylib;/home/user/dep" - CMakeLists.txt 中设置（仅用于开发调试，不推荐进 Git）：
set(CMAKE_PREFIX_PATH "/home/user/opencv-4.8.1/install" ${CMAKE_PREFIX_PATH})必须放在find_package()之前，且不能覆盖用户传入的值（所以加在开头并拼接） - 环境变量（慎用）：
export CMAKE_PREFIX_PATH="/home/user/opencv-4.8.1/install"，适用于 CI 或固定构建环境，但容易和系统其他项目冲突
find_package 的 NO_MODULE 和 CONFIG 模式区别
本地库几乎都走 CONFIG 模式（即依赖 xxxConfig.cmake），但如果你遇到 find_package(XXX REQUIRED) 总失败，可能是它默认尝试 MODULE 模式（找 FindXXX.cmake）。
- 显式指定 CONFIG 模式：
find_package(OpenCV REQUIRED CONFIG)—— 强制只找OpenCVConfig.cmake，避免误入 MODULE 模式搜不到 - MODULE 模式需要手动提供
FindXXX.cmake，通常没必要；本地库自带 Config 文件时，CONFIG 是唯一合理选择 - 某些旧库（如早期 Qt）可能只有 MODULE 模式支持，这时得自己写
FindXXX.cmake或改用 pkg_check_modules
路径结构不对怎么办？
如果本地库没生成 lib/cmake/xxx/，而是只有头文件 + .so/.a，那 find_package 无法直接用，得退化为手动 find_path + find_library。
- 典型“野路子”结构：
/path/to/mylib/include/+/path/to/mylib/lib/libmylib.so - 手动查找示例：
find_path(MYLIB_INCLUDE_DIR NAMES mylib.h PATHS /path/to/mylib/include)<br>find_library(MYLIB_LIBRARY NAMES mylib PATHS /path/to/mylib/lib)<br>if(MYLIB_INCLUDE_DIR AND MYLIB_LIBRARY)<br> add_library(mylib IMPORTED)<br> set_property(TARGET mylib PROPERTY IMPORTED_LOCATION ${MYLIB_LIBRARY})<br> target_include_directories(mylib INTERFACE ${MYLIB_INCLUDE_DIR})<br>endif() - 这样绕过
find_package，但失去版本检查、依赖传递等特性，适合临时救急
真正省事的办法还是让库生成标准 Config 文件：编译时加 -DBUILD_SHARED_LIBS=ON -DCMAKE_INSTALL_PREFIX=/your/path，install 后检查 lib/cmake/ 是否存在对应目录。
