绝大多数find_package报错是因CMake未找到对应配置文件，而非库未安装；报错含“By not providing ‘FindXXX.cmake’”表明Module模式失败，应检查实际安装的*Config.cmake文件并正确使用CONFIG模式或修正包名大小写。
直接说结论：绝大多数 find_package 报错不是“库没装”，而是 CMake 没找到对应的配置文件——它在找 FindXXX.cmake 还是 XXXConfig.cmake，取决于你写的包名、CMake 版本、库的安装方式，以及你有没有告诉它去哪找。
报错信息里出现 “By not providing ‘FindXXX.cmake’” 是什么信号？
这是典型的 Module 模式失败提示，说明 CMake 默认尝试找 FindXXX.cmake 文件（比如 FindOpenCV.cmake），但没在 CMAKE_MODULE_PATH 或内置模块路径里发现它。
- 常见于旧教程或手动编写的
find_package(XXX)，而目标库（如 OpenCV 4.5+、nvpl、Eigen3）实际只提供 Config 模式文件（XXXConfig.cmake） - 如果你写的是
find_package(Opencv)，CMake 会去找FindOpencv.cmake—— 但官方不提供这个文件，只提供OpenCVConfig.cmake，大小写不匹配直接失败 - 此时硬塞
FindXXX.cmake到CMAKE_MODULE_PATH是绕路；更正包名或切换到 Config 模式才是正解
怎么判断该用 Module 还是 Config 模式？
看库安装后生成的文件，而不是文档或别人写的 CMakeLists.txt。
- 进你的库安装目录（比如
/usr/local/lib/cmake/或/opt/nvpl/lib/cmake/），执行：find /path/to/install -name "*Config.cmake" -o -name "Find*.cmake" 2>/dev/null - 如果看到
nvplConfig.cmake或OpenCVConfig.cmake→ 必须用 Config 模式：find_package(nvpl REQUIRED CONFIG)（注意大小写！nvpl小写，OpenCV大驼峰） - 如果只看到
FindEigen3.cmake→ Module 模式可用，但需确保该路径已加入CMAKE_MODULE_PATH - 若两者都存在，CMake 默认优先 Module 模式；加
CONFIG关键字可强制走 Config 模式
路径没设对，CMake 就是找不到，怎么办？
CMake 不会自动扫描你装库的任意位置。它按固定顺序查路径，你得把库的 config 文件所在目录“塞”进去。
- 最推荐：设置
<packagename>_ROOT</packagename>变量（CMake 3.12+），例如：cmake -DOpenCV_ROOT=/usr/local -B build—— 它比CMAKE_PREFIX_PATH优先级更高 - 次选：用
CMAKE_PREFIX_PATH，指向包含lib/cmake/XXX/的父目录，例如：cmake -DCMAKE_PREFIX_PATH=/opt/nvpl -B build - 不推荐硬编码路径：在
CMakeLists.txt里写set(OpenCV_DIR "/usr/local/lib/cmake/opencv4")，虽有效但破坏可移植性 - vcpkg 用户注意：
vcpkg install xxx后，必须把vcpkg_installed/<triplet>/share/xxx/</triplet>加入CMAKE_MODULE_PATH或用vcpkg integrate install
大小写、下划线、连字符，一个字母错就白忙
CMake 对包名大小写敏感，且 Config 模式下的文件名必须与 find_package() 参数严格一致（除首字母外通常全小写，但 OpenCV 是例外）。
-
find_package(OpenCV)→ 找OpenCVConfig.cmake（正确） -
find_package(opencv)→ 找opencvConfig.cmake（几乎不存在） -
find_package(nvpl)→ 找nvplConfig.cmake（CUDA 12.4+ 官方路径下存在） -
find_package(nvPL)→ 找nvPLConfig.cmake（失败） - ECM 是个特例：它提供的是
ECMConfig.cmake，但要求调用时写find_package(ECM REQUIRED CONFIG)，且需额外设置ECM_MODULE_PATH给内部宏用
最容易被忽略的点：nvpl 和 OpenCV 这类现代库，根本没发布过 Findnvpl.cmake 或 FindOpenCV.cmake —— 文档滞后和社区误传导致很多人徒劳地在网上搜这个文件。直接检查你本地安装目录里的真实文件名，比读教程管用得多。
