find_package(opencv required) 报错主因是 cmake 无法定位 opencvconfig.cmake 文件，该文件仅存在于编译安装或包管理器安装后的 lib/cmake/opencv4 目录；需确保路径正确、显式声明头文件与链接模块，并清理 build 目录刷新缓存。
直接用 find_package(OpenCV REQUIRED) 就能完成基础配置，但实际项目里几乎一定会卡在头文件找不到、链接失败或版本不匹配上——核心问题不是“会不会写”，而是 CMake 怎么定位你本地装的 OpenCV，以及怎么把路径、组件、架构对齐。
find_package(OpenCV REQUIRED) 为什么经常报错
这个命令本身没问题，但它依赖 CMake 能自动找到 OpenCV 的 OpenCVConfig.cmake 或 opencv-config.cmake 文件。而这个文件只存在于你「自己编译安装」或「用包管理器安装」后的 lib/cmake/opencv4（或 opencv3）目录下，不是解压源码就有的。
- 如果你只是下载了 OpenCV 源码但没运行
make install，find_package必然失败 - Windows 下预编译包通常把
OpenCVConfig.cmake放在build\install\x64\vc17\lib\cmake\opencv4这类路径，必须确保该路径被 CMake 搜索到 - Linux 下 apt 安装的 OpenCV（如
libopencv-dev）会把配置文件放在/usr/lib/x86_64-linux-gnu/cmake/opencv4，CMake 默认能扫到；但手动编译安装到/opt/opencv就需要额外指定CMAKE_PREFIX_PATH
CMakeLists.txt 里怎么写才不漏关键项
光有 find_package 不够，还得显式声明头文件、链接目标、检查组件。漏掉任意一项，编译或链接阶段就会崩。
- 必须加
include_directories(${OpenCV_INCLUDE_DIRS})，否则#include <opencv2></opencv2>直接报错 -
target_link_libraries(your_target ${OpenCV_LIBS})是最简写法，但更推荐用target_link_libraries(your_target opencv_core opencv_imgproc opencv_highgui)—— 显式列出所需模块，避免隐式依赖和跨平台 ABI 不一致问题 - 加一句
message(STATUS "OpenCV version: ${OpenCV_VERSION}")，能在 configure 阶段立刻确认是否找到了你要的版本，而不是等到编译出错才排查
Windows + VS 下常见路径陷阱
VS 编译生成的库名带后缀（opencv_world480d.lib debug / opencv_world480.lib release），CMake 默认不会自动区分，容易链接错。
- 不要硬写
link_directories("Y:/.../vc17/lib")，改用find_package(OpenCV REQUIRED PATHS "Y:/.../vc17")，让 CMake 自动选对路径 - 如果用了
opencv_world，确保find_package时加COMPONENTS world，否则${OpenCV_LIBS}可能为空 - Qt 项目里还混着
WITH_QT=ON编译的 OpenCV？那必须确认Qt5_DIR环境变量或 CMake cache 里指向的是同一套 Qt，否则opencv_highgui会链接失败，报一堆undefined reference to `QApplication::QApplication'
最常被忽略的一点：CMake cache 一旦生成，就不会自动刷新路径。改了 OpenCV 安装位置或重装了新版，必须删掉整个 build 目录重新 configure，否则它还在用旧的缓存路径找库。
