根本原因是cmake找不到findopencv.cmake或opencvconfig.cmake文件；需通过设置opencv_dir、cmake_module_path或cmake_prefix_path显式告知配置文件路径，而非依赖自动搜索。
find_package 不是“安装后就能用”的功能，它依赖你本地是否已有对应包的查找逻辑（Find*.cmake 或 *Config.cmake），CMake 自身只提供查找机制，不自带第三方库的配置文件。
为什么 find_package(OpenCV) 有时报错找不到？
根本原因不是 CMake 没装好，而是：find_package 找不到 FindOpenCV.cmake 或 OpenCVConfig.cmake 这两个关键文件中的任意一个。
- 如果系统已通过
apt install libopencv-dev（Ubuntu）或brew install opencv（macOS）安装 OpenCV，通常会自带OpenCVConfig.cmake，但路径可能不在 CMake 默认搜索范围内 - 如果只编译安装了 OpenCV 但没执行
make install，或安装时没指定-DCMAKE_INSTALL_PREFIX，那OpenCVConfig.cmake可能散落在 build 目录里，CMake 根本看不到 - 某些旧版 OpenCV（如 3.x）只提供
FindOpenCV.cmake，而它又依赖OpenCV_DIR环境变量或CMAKE_MODULE_PATH手动设置
如何让 find_package 找到你已安装的库？
核心思路：告诉 CMake “去哪找配置文件”，而不是“去哪找头文件或 so 文件”。
- 查已安装库是否带
*Config.cmake：运行find /usr -name "OpenCVConfig.cmake" 2>/dev/null或find /opt/homebrew -name "*Config.cmake" 2>/dev/null - 若找到，比如路径是
/usr/lib/x86_64-linux-gnu/cmake/opencv4，就在CMakeLists.txt中加一行：set(OpenCV_DIR "/usr/lib/x86_64-linux-gnu/cmake/opencv4") - 若只有
FindOpenCV.cmake（比如从源码编译但没 install），把它拷贝到项目目录下cmake/Modules/，再加：set(CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}/cmake/Modules" ${CMAKE_MODULE_PATH}) - 全局生效可设环境变量：
export OpenCV_DIR="/path/to/opencv-config"（注意：仅对当前 shell 有效）
find_package 后变量名到底怎么拼？
没有统一规则，取决于具体 Find*.cmake 或 *Config.cmake 文件里怎么定义。别猜，直接看实际生成的变量：
- 运行
cmake -LH ..（在 build 目录执行），列出所有缓存变量，搜OpenCV相关项 - 常见命名有：
OpenCV_INCLUDE_DIRS、OpenCV_INCLUDE_DIR、OpenCV_LIBS、OpenCV_LIBRARIES、OpenCV_VERSION - 安全写法是先检查
if(OpenCV_FOUND)，再用message(STATUS "OpenCV include: ${OpenCV_INCLUDE_DIRS}")打印确认 - 现代 CMake 推荐用目标式写法：
target_link_libraries(my_target PRIVATE OpenCV::opencv_core)—— 这要求库本身导出了 IMPORTED targets（即 Config 模式且正确安装）
最容易被忽略的一点：CMake 的 find_package 查找顺序是先 Module 模式（找 Find*.cmake），失败后再 fallback 到 Config 模式（找 *Config.cmake）。如果你手动设置了 CMAKE_MODULE_PATH 却没放对文件，或者误删了系统里的 OpenCVConfig.cmake，它就永远卡在 Module 模式里打转，而你根本不知道它根本没进 Config 阶段。
