根本原因是find_package成功后未显式添加头文件路径，必须用target_include_directories()或include_directories()将${OpenCV_INCLUDE_DIRS}传给编译器；同时需用target_link_libraries()链接${OpenCV_LIBS}，否则会出现头文件找不到或链接失败。
find_package 指定了 OpenCV_DIR 却 still 报 opencv2/opencv.hpp not found
根本原因不是 find_package 失败，而是它找到的头文件路径没被编译器实际使用。CMake 不会自动把 ${OpenCV_INCLUDE_DIRS} 加入编译命令，必须显式调用 include_directories() 或更推荐的 target_include_directories()。
常见错误写法：
set(OpenCV_DIR "/opt/opencv/build") find_package(OpenCV REQUIRED) # ❌ 缺少 include 声明，编译器完全不知道头文件在哪 add_executable(myapp main.cpp)
正确做法（按 target 粒度控制）：
target_include_directories(myapp PRIVATE ${OpenCV_INCLUDE_DIRS})- 确保
myapp是你用add_executable()或add_library()定义的目标名 - 别用全局的
include_directories()，它会让所有 target 都继承该路径，容易污染和冲突
find_package 找到库但链接时报 undefined reference
这说明头文件路径生效了（编译通过），但链接器找不到符号 —— find_package 设置的库变量没传给链接阶段。
关键点：
-
find_package(OpenCV REQUIRED)后，真正要链接的是${OpenCV_LIBS}或更细粒度的${OpenCV_LIBRARIES}（二者常等价，但不同 CMake 版本略有差异） -
target_link_libraries(myapp ${OpenCV_LIBS})必须写，且顺序不能颠倒：目标名在前，库变量在后 - 如果用了
COMPONENTS（如find_package(OpenCV REQUIRED COMPONENTS core imgproc)），${OpenCV_LIBS}只含指定组件，漏掉会导致链接失败
Windows 下 find_package 找到 OpenCVConfig.cmake 却提示 missing XXX_INCLUDE_DIR
这是典型的 Config 模式解析失败。Windows 上很多预编译 OpenCV 包的 OpenCVConfig.cmake 依赖内部变量（比如 OpenCV_INSTALL_PATH）拼接路径，而这些变量可能为空或指向不存在的位置。
验证与修复步骤：
- 打开
${OpenCV_DIR}/OpenCVConfig.cmake，搜索set(OpenCV_INCLUDE_DIRS，看它是否用了未定义变量（如${OpenCV_INSTALL_PATH}/include） - 手动补全缺失路径：
set(OpenCV_INCLUDE_DIRS "C:/opencv/build/install/include") - 或绕过 Config 模式，改用 Module 模式：把官方提供的
FindOpenCV.cmake放进项目cmake/目录，再加set(CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}/cmake" ${CMAKE_MODULE_PATH})
Linux 上 apt 安装的 OpenCV，find_package 成功但头文件路径不对
Ubuntu/Debian 的 libopencv-dev 包通常把 OpenCVConfig.cmake 放在 /usr/lib/x86_64-linux-gnu/cmake/opencv4/（OpenCV 4.x）或 /usr/share/OpenCV/（OpenCV 2.x/3.x），但 CMake 默认不查这些路径。
解决方法（任选其一）：
- 设
OpenCV_DIR：运行find /usr -name "OpenCVConfig.cmake" 2>/dev/null，把输出路径的父目录赋给OpenCV_DIR（例如/usr/lib/x86_64-linux-gnu/cmake/opencv4） - 用 pkg-config fallback：
find_package(OpenCV REQUIRED CONFIG)失败后，加find_package(PkgConfig REQUIRED)+pkg_check_modules(OPENCV REQUIRED IMPORTED_TARGET opencv4)，再用target_link_libraries(myapp PkgConfig::OPENCV) - 直接硬编码（仅调试用）：
target_include_directories(myapp PRIVATE /usr/include/opencv4)
最容易被忽略的是：OpenCV 4.x 的头文件路径是 /usr/include/opencv4/opencv2/...，而代码里仍写 #include —— 这要求 include path 必须是 /usr/include/opencv4，不是 /usr/include。漏掉 opencv4 这一层，就必然找不到。
