find_package默认按固定顺序搜索config或module模式下的.cmake文件，不会优先查找用户指定目录；必须通过opencv_dir等变量配合no_default_path，或cmake_prefix_path、cmake_module_path显式干预路径，才能确保准确命中目标版本。
find_package 默认不会优先搜索你指定的目录，它按固定顺序查 Config 或 Module 模式下的 .cmake 文件。想让它「先去你给的路径找」，必须显式干预搜索逻辑，否则它可能跳过你的目录、直接命中系统自带旧版本。
用 _DIR 变量强制指定 Config 模式路径
这是最直接、最可靠的方式，适用于你已知包自带 xxxConfig.cmake 文件（比如自己编译安装、或第三方 SDK 提供的）。
-
_DIR变量名必须全大写、严格匹配包名，例如OpenCV_DIR、yaml-cpp_DIR、Protobuf_DIR - 变量值必须是包含
xxxConfig.cmake的**目录路径**，不是文件路径，也不是安装根目录（除非xxxConfig.cmake就在根下） - 必须搭配
NO_DEFAULT_PATH，否则 CMake 仍会继续查系统路径，可能覆盖你的设置 - 示例：
set(OpenCV_DIR "/opt/opencv-4.8.1/lib/cmake/opencv4")<br>find_package(OpenCV 4.8.1 REQUIRED NO_DEFAULT_PATH)
用 CMAKE_PREFIX_PATH 扩展 Config 模式搜索范围
当你要同时指定多个自定义前缀（比如多个第三方库都装在 /opt/thirdparty 下），比逐个设 _DIR 更轻量。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
CMAKE_PREFIX_PATH是一个 list，CMake 会在每个路径下依次查找lib/cmake/<name>/</name>、share/cmake/<name>/</name>等子目录中的Config.cmake - 它不替代
_DIR，但优先级高于系统默认路径（如/usr/lib/cmake） - 注意：路径末尾不要加
/lib/cmake/xxx，只填前缀，CMake 会自动拼接子路径 - 示例：
set(CMAKE_PREFIX_PATH "/opt/thirdparty;/home/user/local")<br>find_package(protobuf REQUIRED)
用 CMAKE_MODULE_PATH 控制 Module 模式查找
当你用的是 FindXXX.cmake（比如系统没提供 xxxConfig.cmake，或你想用自己写的查找逻辑），这个变量决定「先在哪找 FindXXX.cmake」。
-
CMAKE_MODULE_PATH是 list，CMake 按顺序扫描每个路径，找Find<packagename>.cmake</packagename> - 必须在
find_package()前设置，且推荐用list(APPEND ...)而非set()，避免覆盖 CMake 自带 Modules 路径 - 常见错误：把路径设成
./cmake/FindXXX.cmake，实际应设为./cmake（目录） - 示例：
list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake")<br>find_package(mylib MODULE REQUIRED)
为什么 NO_DEFAULT_PATH 很关键
不加它，CMake 会在你指定的路径之后，继续查 /usr、/usr/local、CMake 自带 Modules 等所有默认路径——一旦这些路径里有同名但版本更低或 ABI 不兼容的 .cmake 文件，就会被误用。
-
NO_DEFAULT_PATH表示「只查我明确告诉你的地方」，彻底屏蔽默认行为 - 它只对当前
find_package()生效，不影响后续其他包 - 如果指定路径下找不到
Config.cmake或FindXXX.cmake，CMake 直接报错，不会 fallback —— 这正是你想要的确定性
真正容易被忽略的点是：路径精度。比如 OpenCV_DIR 设成 /opt/opencv/build 却发现里面没有 OpenCVConfig.cmake，其实它在 /opt/opencv/build/lib/cmake/opencv4/；又或者 CMAKE_MODULE_PATH 指向了空目录，导致 find_package 静默失败。动手前，先 ls 确认目标 .cmake 文件真实存在且位置符合 CMake 的预期结构。
