根本原因是CMake默认只搜索系统路径（如/usr/local或Windows注册表），不会自动查找用户手动安装的OpenCV目录；必须显式设置-DOpenCV_DIR=/path/to/opencv/build/install/share/opencv4，路径必须精确到share/opencv4子目录，否则find_package(OpenCV REQUIRED)将静默失败。
find_package(OpenCV REQUIRED) 为什么总报错找不到
根本原因不是 OpenCV 没装，而是 CMake 根本没去你装的地方找。默认情况下，find_package(OpenCV) 只查系统路径（比如 /usr/local 或 Windows 的注册表），不会自动扫描你手动解压的源码目录或自定义 build 目录。
- 如果你是源码编译安装的 OpenCV，必须在运行
cmake命令时显式指定路径：cmake -DOpenCV_DIR=/path/to/opencv/build/install/share/opencv4 ..（注意是share/opencv4，不是lib或bin） - 如果用的是预编译包（如官网 Windows 版），确保
OpenCV_DIR指向其build\install\share\opencv4子目录（不是build\install\x64\vc17\bin） - Linux 下若用
apt install libopencv-dev安装，一般不用设OpenCV_DIR；但若混用源码版和系统版，CMake 可能优先选错版本，此时必须强制指定
CMakeLists.txt 里 link_directories 和 target_link_libraries 怎么配才不炸
link_directories 是全局作用域，容易污染其他 target；target_link_libraries 才是现代 CMake 推荐写法，且必须放在 add_executable 或 add_library 之后。
- 错误写法：
link_directories(${OpenCV_LIBRARY_DIR})+target_link_libraries(myapp ${OpenCV_LIBRARIES})——${OpenCV_LIBRARIES}是完整路径列表，再加link_directories会导致重复链接或路径冲突 - 正确写法：直接
target_link_libraries(myapp ${OpenCV_LIBRARIES})，CMake 会自动从${OpenCV_LIBRARIES}提取路径并传递给 linker - 更稳妥做法：用
find_package(OpenCV REQUIRED)后，只传库名（如opencv_core opencv_imgproc），CMake 自动解析依赖关系，避免硬编码路径
Windows 下 MinGW 编译 OpenCV 时 configure 总卡在 ffmpeg/ippicv
这不是配置错误，是 CMake 在 configure 阶段尝试自动下载第三方依赖，而国内网络常连不上 OpenCV 的 3rdparty 服务器。
- 打开
build/CMakeDownloadLog.txt，找到失败 URL（如ffmpeg-*.zip、ippicv_*.icc） - 手动下载对应文件（注意 MD5 必须匹配），放到
build/3rdparty/downloads对应子目录下（路径名需与日志中提示的一致） - 删掉
build/CMakeCache.txt，重新cmake-gui→Configure，CMake 会跳过已存在的文件 - 实在不想折腾，可关掉相关选项：
WITH_FFMPEG=OFF、OPENCV_DNN=OFF、OPENCV_ENABLE_NONFREE=OFF（除非真要用 SURF）
Qt + OpenCV + CMake 项目里头文件能 include，但链接时报 undefined reference
这说明头文件路径对了，但链接器根本没看到 OpenCV 的 .a/.so/.lib 文件——大概率是 target_link_libraries 里漏了库，或者库和编译器 ABI 不匹配。
- 检查 Qt 工具链和 OpenCV 编译时是否一致：MinGW 8.1 编的 OpenCV，就不能用 MinGW 11.2 的 Qt 项目去 link
- 确认
${OpenCV_LIBRARIES}展开后是否包含实际库文件（比如opencv_core opencv_imgproc），而不是空字符串——可在CMakeLists.txt加message(STATUS "OpenCV_LIBS: ${OpenCV_LIBRARIES}")调试 - Qt 项目常用
find_package(OpenCV REQUIRED)后，target_link_libraries(myqtapp PRIVATE ${OpenCV_LIBRARIES} Qt5::Core Qt5::Gui)，注意PRIVATE作用域别写成PUBLIC导致下游 target 污染
CMake 配 OpenCV 最容易被忽略的点，其实是 OpenCV_DIR 的路径精度——差一个 share/opencv4，整个 find_package 就静默失败，而且不报错，只让后续 include_directories 和 target_link_libraries 全部失效。
