不能靠 find_package 自己指定安装目录，而需通过设置 opencv_dir 变量或 cmake_prefix_path 告诉 cmake 配置文件位置；opencv_dir 必须指向含 opencvconfig.cmake 的直接父目录，如 /opt/opencv-4.8.1/lib/cmake/opencv4。
直接结论：不能靠 find_package 自己“指定安装目录”，而是要告诉 CMake 去哪找配置文件（xxxConfig.cmake）——关键在设置 xxx_DIR 变量或 CMAKE_PREFIX_PATH，不是传路径给 find_package 本身。
为什么 find_package(OpenCV) 找不到你源码编译安装的 OpenCV？
因为你把 OpenCV 装到了 /opt/opencv-4.8.1，但 CMake 默认只查 /usr、/usr/local、/opt（部分系统）这些前缀路径下的 share/cmake/ 或 lib/cmake/ 子目录。它不会自动扫描你随便指定的路径。
常见现象：find_package(OpenCV REQUIRED) 报错 Could not find a package configuration file provided by "OpenCV"，哪怕你确认 OpenCVConfig.cmake 就在 /opt/opencv-4.8.1/lib/cmake/opencv4/ 下。
- 根本原因：CMake 没去那个路径下找
OpenCVConfig.cmake - 不是 OpenCV 没装好，是 CMake 不知道该去哪翻
-
find_package查的是配置文件，不是库文件本身
xxx_DIR 变量是最直接的指定方式
对大多数现代库（OpenCV、Qt、yaml-cpp 等），它们提供 xxxConfig.cmake，CMake 支持用 <packagename>_DIR</packagename> 变量显式指定其所在目录。这个变量必须在 find_package 之前设置。
示例（OpenCV 安装在 /opt/opencv-4.8.1）：
set(OpenCV_DIR "/opt/opencv-4.8.1/lib/cmake/opencv4") find_package(OpenCV REQUIRED)
注意点：
-
OpenCV_DIR必须指向包含OpenCVConfig.cmake的**直接父目录**，不是lib或share，而是那个有OpenCVConfig.cmake的文件夹（通常是lib/cmake/opencv4或share/opencv4） - 变量名大小写敏感：OpenCV →
OpenCV_DIR；yaml-cpp →yaml-cpp_DIR（含连字符）；Eigen →Eigen3_DIR（官方命名习惯） - 如果设置后仍失败，用
message(STATUS "OpenCV_DIR = ${OpenCV_DIR}")确认变量值是否正确、路径是否存在
用 CMAKE_PREFIX_PATH 批量添加搜索根路径
当你有多个自定义安装的库（比如同时用了 /opt/opencv-4.8.1 和 /opt/eigen-3.4.0），一个个设 xxx_DIR 太累，改用 CMAKE_PREFIX_PATH 更省事。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
它是一组“前缀路径”，CMake 会自动在每个前缀下尝试查找 lib/cmake/xxx、share/xxx 等标准子路径：
list(APPEND CMAKE_PREFIX_PATH "/opt/opencv-4.8.1" "/opt/eigen-3.4.0") find_package(OpenCV REQUIRED) find_package(Eigen3 REQUIRED)
关键细节：
-
CMAKE_PREFIX_PATH是分号分隔的列表（Windows）或冒号分隔（Linux/macOS），但 CMake 内部统一用分号，所以用list(APPEND ...)最安全 - 它影响所有后续
find_package调用，适合项目级统一配置 - 优先级低于
xxx_DIR：如果同时设了OpenCV_DIR和CMAKE_PREFIX_PATH，CMake 会先用OpenCV_DIR - 不要把
lib/cmake/opencv4这种深层路径塞进去——只填前缀，如/opt/opencv-4.8.1
NO_DEFAULT_PATH 是把双刃剑
有人看到文档里有 NO_DEFAULT_PATH 参数，就想“我只要搜我指定的路径，别去系统目录找”，于是这么写：
find_package(yaml-cpp 1.12 REQUIRED NO_DEFAULT_PATH PATHS "/opt/yaml-cpp-1.12.0/lib/cmake/yaml-cpp")
这确实能强制只查你给的路径，但容易踩坑：
- 路径必须精确到包含
yaml-cpp-config.cmake的目录（不是lib，也不是cmake，而是cmake/yaml-cpp） - 一旦路径写错（比如少个
yaml-cpp子目录），就彻底失败，且错误信息不提示具体在哪找的——只会说“not found” - 它禁用了所有默认路径（包括
CMAKE_PREFIX_PATH和xxx_DIR），反而让调试更困难 - 除非你明确要隔离环境（如 CI 构建），否则不推荐日常使用
真正需要隔离时，更稳妥的做法是：清空 CMAKE_PREFIX_PATH + 显式设 yaml-cpp_DIR，比硬塞 NO_DEFAULT_PATH 更可控。
最常被忽略的一点：CMake 不会递归扫描整个磁盘。它只按固定规则在有限路径集里找几个特定名字的 .cmake 文件。你以为装好了，其实只是没告诉 CMake 去哪翻那张“藏宝图”。
