根本原因是CMake未在安装路径下搜索，应优先设置xxx_DIR变量指向含XXXConfig.cmake的目录（如set(OpenCV_DIR "/opt/opencv-4.7.0/lib/cmake/opencv4")），且必须置于find_package(OpenCV REQUIRED)之前；其次可设CMAKE_PREFIX_PATH统一指定多个库根目录；若无Config文件则需改用find_path/find_library或自定义FindXXX.cmake。
find_package 报错 “Could not find a package configuration file” 怎么办
这不是库没装，而是 CMake 根本没去你装库的地方找。它默认只查 /usr、/usr/local、/opt/homebrew（macOS）等固定前缀下的 lib/cmake/PackageName/ 或 share/cmake/PackageName/，你把 OpenCV 装到 /opt/opencv-4.7.0，它默认不看。
关键不是“加路径”，而是“控制搜索顺序”。CMake 查找有明确优先级：先看 <packagename>_DIR</packagename>，再看 CMAKE_PREFIX_PATH，最后才轮到系统默认路径。
- 先确认目标库是否提供
XXXConfig.cmake文件（如OpenCVConfig.cmake、ProtobufConfig.cmake），通常在安装目录的lib/cmake/xxx/下 - 如果只有头文件和
.so/.a但没有 Config 文件，find_package会直接 fallback 到 Module 模式，此时得自己提供FindXXX.cmake或改用find_path+find_library - 别依赖
PKG_CONFIG_PATH——find_package基本不读这个环境变量
设置 <packagename>_DIR</packagename> 变量最直接有效
这是最高优先级方式，CMake 会跳过所有默认路径，直奔你指定的目录找 XXXConfig.cmake。
注意大小写必须完全一致：find_package(OpenCV) 对应 OpenCV_DIR，不是 opencv_DIR 或 OpenCV_dir；find_package(protobuf) 对应 protobuf_DIR（小写 p）。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
- 在
find_package之前设置，例如：set(OpenCV_DIR "/opt/opencv-4.7.0/lib/cmake/opencv4") find_package(OpenCV REQUIRED)
- 路径必须精确到包含
OpenCVConfig.cmake的那一层，不是上一级/opt/opencv-4.7.0 - 可以在命令行传入，避免改
CMakeLists.txt：cmake -DOpenCV_DIR=/opt/opencv-4.7.0/lib/cmake/opencv4 ..
CMAKE_PREFIX_PATH 适合多个库共用一个安装根目录
当你把 Boost、Protobuf、OpenCV 全部手动编译装到 /opt/mydeps，每个子库都在 /opt/mydeps/lib/cmake/xxx/ 下，这时设一堆 _DIR 变量太啰嗦，统一设 CMAKE_PREFIX_PATH 更清爽。
-
CMAKE_PREFIX_PATH是一个分号分隔的路径列表，CMake 会依次在每个前缀下查找lib/cmake/xxx/和share/cmake/xxx/ - 在
CMakeLists.txt开头设置：set(CMAKE_PREFIX_PATH "/opt/mydeps;/home/user/local" CACHE PATH "") find_package(OpenCV REQUIRED) find_package(protobuf REQUIRED)
- 命令行方式更常用：
cmake -DCMAKE_PREFIX_PATH="/opt/mydeps;/home/user/local" .. - 注意：该变量对已通过
_DIR显式指定的包无效 ——_DIR优先级更高
找不到 Config 文件时，别硬扛 find_package
有些库（尤其是老版本或精简打包）根本不提供 XXXConfig.cmake，比如某些发行版的 libjpeg 或自建的私有模块。这时 find_package(JPEG) 会退回到 Module 模式，而官方 FindJPEG.cmake 又可能找不到你的安装位置，结果就是无限循环报错。
- 检查
CMAKE_MODULE_PATH是否包含你自己的cmake/Modules/目录，并放一个定制版FindJPEG.cmake - 更轻量的做法是绕过
find_package，直接用原生命令定位：find_path(JPEG_INCLUDE_DIR jpeglib.h HINTS "/opt/jpeg/include") find_library(JPEG_LIBRARY jpeg HINTS "/opt/jpeg/lib") include_directories(${JPEG_INCLUDE_DIR}) target_link_libraries(myapp ${JPEG_LIBRARY}) - 如果必须用
find_package接口，可配合NO_MODULE强制走 Config 模式，再用HINTS指定路径：find_package(JPEG NO_MODULE HINTS "/opt/jpeg")，但这要求你手动生成兼容的 Config 文件
真正容易被忽略的是：CMake 不会自动递归扫描子目录，HINTS 和 PATHS 给的必须是 Config 文件的**父目录**，不是安装根目录；而 _DIR 变量给的必须是 Config 文件所在目录本身 —— 差一层就彻底找不到。
