find_package无法直接通过命令行传路径，本质是通过-dxxx_dir=路径提前设置变量，使cmake在config模式下优先在该路径查找xxxconfig.cmake文件；路径须精确指向含配置文件的子目录，且变量名与find_package参数严格一致。
find_package 用命令行传目录，本质是设置 _DIR 变量
直接传路径给 find_package 是做不到的——它不接受路径参数。真正起作用的是提前设置好形如 XXX_DIR 的变量（比如 OpenCV_DIR、Python3_DIR），CMake 会在配置阶段读取它，并优先在该路径下找 XXXConfig.cmake 文件。
所以你不是“传给 find_package”，而是“传给 cmake 命令本身”，通过 -D 设置变量：
cmake -DOpenCV_DIR=/opt/opencv-4.8.1/lib/cmake/opencv4 ..
注意：OpenCV_DIR 必须指向包含 OpenCVConfig.cmake（或 opencv4-config.cmake）的目录，不是库文件所在目录，也不是安装根目录。
-
OpenCV_DIR指向/opt/opencv-4.8.1/lib/cmake/opencv4✅（正确） -
OpenCV_DIR指向/opt/opencv-4.8.1❌（除非该目录下有lib/cmake/opencv4/子路径且被自动探测到） -
OpenCV_DIR指向/opt/opencv-4.8.1/lib❌（缺少cmake/opencv4/层级）
多个库共存时，_DIR 变量必须一一对应
如果你同时装了 OpenCV 3 和 OpenCV 4，又用了 Qt 5 和 Qt 6，不能只设一个通用路径。每个库都要单独指定自己的 _DIR：
cmake \ -DOpenCV_DIR=/opt/opencv-4.8.1/lib/cmake/opencv4 \ -DQt5_DIR=/opt/qt5.15.2/lib/cmake/Qt5 \ -DQt6_DIR=/opt/qt6.7.2/lib/cmake/Qt6 \ ..
这些变量名大小写敏感，且必须和 find_package() 中写的包名完全一致（包括数字和大小写）：
-
find_package(OpenCV REQUIRED)→ 对应OpenCV_DIR -
find_package(Qt6 REQUIRED)→ 对应Qt6_DIR -
find_package(Python3 REQUIRED)→ 对应Python3_DIR，不是PYTHON_DIR或Python_DIR
没 Config 文件？那就得走 Module 模式 + CMAKE_MODULE_PATH
像旧版 Boost、某些自编译库可能根本不带 XXXConfig.cmake，这时 _DIR 变量无效，find_package 会 fallback 到 Module 模式——它只认 FindXXX.cmake 文件。
想让 CMake 找到你自定义的 FindBoost.cmake，得用 CMAKE_MODULE_PATH：
cmake -DCMAKE_MODULE_PATH=/path/to/my/cmake/modules ..
这个路径会被插入到模块搜索队列最前面，优先于 CMake 自带的 Modules/ 目录。
- 路径里不要加
FindBoost.cmake，只填目录 - 目录下必须存在
FindBoost.cmake文件（文件名严格匹配，大小写敏感） - 如果同时设了
Boost_DIR和CMAKE_MODULE_PATH，且 Boost 没 Config 文件，Boost_DIR会被忽略
常见错误：_DIR 设了但没生效
最常踩的坑不是语法错，而是路径语义理解偏差：
-
find_package(OpenCV REQUIRED)执行前，OpenCV_DIR就得已存在——不能在CMakeLists.txt里用set(OpenCV_DIR ...)后再调find_package，因为变量必须在 configure 阶段初就被读取 - 路径末尾不能有多余斜杠：
-DOpenCV_DIR=/opt/opencv//可能导致内部路径拼接失败 - Windows 下路径用正斜杠或双反斜杠均可，但单反斜杠
\在 shell 中要转义，容易出错，建议统一用/ -
find_package(XXX CONFIG REQUIRED)强制 Config 模式后，XXX_DIR才真正起效；若没加CONFIG，CMake 可能先走 Module 模式并忽略XXX_DIR
实际调试时，加 -Wdev 或在 CMakeLists.txt 里写 message(STATUS "OpenCV_DIR = ${OpenCV_DIR}")，确认变量是否真被读进来了。
