CMake报“Could not find a package configuration file provided by 'OpenCV'”，90%是因为未找到OpenCVConfig.cmake文件；需用find或Get-ChildItem命令定位其所在目录，再将该目录路径赋给OpenCV_DIR（非文件路径），且必须置于find_package(OpenCV REQUIRED)之前。
直接说结论：CMake报 Could not find a package configuration file provided by "OpenCV"，90%是因为它根本没找到 OpenCVConfig.cmake 文件——不是没装OpenCV，是路径没对上。
怎么快速定位OpenCVConfig.cmake在哪？
别猜，用系统命令直接搜。这个文件才是CMake Config模式真正要找的“信物”：
-
Linux/macOS：运行
find /usr -name "OpenCVConfig.cmake" 2>/dev/null或更全一点sudo find / -name "OpenCVConfig.cmake" 2>/dev/null -
Windows（PowerShell）：运行
Get-ChildItem -Path "C:\" -Recurse -Name "OpenCVConfig.cmake" -ErrorAction SilentlyContinue - 常见位置包括：
/usr/local/lib/cmake/opencv4/、/usr/share/opencv4/、C:/opencv/build/install/x64/vc17/lib/cmake/opencv4/ - 注意版本号后缀：OpenCV 4.x 的配置文件通常在
opencv4/子目录下，不是opencv/；3.x 可能在opencv/或OpenCV/
在CMakeLists.txt里设置OpenCV_DIR最稳的方式
找到 OpenCVConfig.cmake 所在目录后，把它父目录（即含 OpenCVConfig.cmake 的那个目录）赋给 OpenCV_DIR，不是文件路径，是目录路径：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 错误写法：
set(OpenCV_DIR "/usr/local/lib/cmake/opencv4/OpenCVConfig.cmake")（这是文件，不是目录） - 正确写法：
set(OpenCV_DIR "/usr/local/lib/cmake/opencv4")（这个目录下必须能列出OpenCVConfig.cmake） - 这行必须放在
find_package(OpenCV REQUIRED)之前，否则无效 - 如果项目要跨机器协作，建议用相对路径或环境变量兜底，比如
set(OpenCV_DIR $ENV{OPENCV_ROOT}/lib/cmake/opencv4)
为什么export OpenCV_DIR或setx不管用？
环境变量生效有前提，不是设了就立刻被CMake读到：
- CMake只在首次配置（
cmake ..）时读取环境变量，改完要删掉build/目录重来 - Linux/macOS：确保
export OpenCV_DIR=...在当前终端生效（别漏掉source ~/.bashrc或source ~/.zshrc） - Windows：用
setx OpenCV_DIR "C:\path\to\opencv4"后，必须新开命令行窗口，旧窗口不继承新变量 - IDE（如CLion、VS Code）可能不加载 shell 的环境变量，需在 IDE 设置里单独配置环境变量，或改用
CMAKE_PREFIX_PATH
OpenCV_FOUND为FALSE但没报错？检查大小写和版本约束
有时候 find_package(OpenCV) 不报错，但后续链接失败，大概率是 OpenCV_FOUND 实际为 FALSE：
-
find_package(OpenCV)默认不强制失败，加REQUIRED才会中断构建：find_package(OpenCV REQUIRED) - OpenCV官方包名是全大写
OpenCV，写成opencv或Opencv会导致 Module 模式 fallback 失败 - 指定版本时注意语法：
find_package(OpenCV 4.5 REQUIRED)—— 中间不能有空格，且版本号必须与OpenCVConfig.cmake里声明的兼容 - 运行
message(STATUS "OpenCV_FOUND: ${OpenCV_FOUND}")确认是否真找到了，别只看有没有红字报错
最容易被忽略的一点：OpenCV 4.x 官方不再提供 FindOpenCV.cmake，硬凑 Module 模式只会绕远路。盯住 OpenCVConfig.cmake 的位置，路径对了，其他都是细节问题。
