OpenCV 各平台常见链接与运行问题：Windows MinGW 需显式链接 opencv_imgcodecs 等模块并确保构建开启；macOS 需手动授权摄像头并指定 AVFoundation 后端；Ubuntu apt 版默认禁用 DNN 模块导致 readNetFromONNX 崩溃。
Windows 上用 MinGW 编译 OpenCV 为什么总报 undefined reference to `cv::imread'
因为默认构建的 OpenCV 静态库没链接 opencv_imgcodecs 模块，而 cv::imread 就在它里面。MinGW 对库依赖更敏感，不像 MSVC 会自动推导隐式依赖。
实操建议：
- 用 CMake 配置时务必勾选
WITH_QT（可选）但必须确保BUILD_opencv_imgcodecs=ON，且OPENCV_DNN=OFF（MinGW 下 dnn 模块容易连带触发链接失败） - 链接时显式加上：
-lopencv_imgcodecs -lopencv_imgproc -lopencv_core，顺序不能颠倒（依赖链：imgcodecs → imgproc → core） - 检查
lib目录下是否存在libopencv_imgcodecs.a，没有就说明构建漏了模块
macOS 上 cv::VideoCapture 打不开摄像头，cap.isOpened() 返回 false
macOS 12+ 默认禁用摄像头权限，OpenCV 不会弹窗提示，只会静默失败。
实操建议：
- 先在系统设置 → 隐私与安全性 → 摄像头，把你的终端（如
Terminal.app或iTerm2）或 IDE（如CLion）手动勾上 - 确认用的是 AVFoundation 后端：编译时加
-D WITH_AVFOUNDATION=ON，否则默认 VideoIO 后端在 macOS 上基本不可用 - 代码里别直接写
cv::VideoCapture cap(0)，改成cv::VideoCapture cap(0, cv::CAP_AVFOUNDATION)显式指定后端
Ubuntu 下用 apt 安装的 libopencv-dev 为什么调用 cv::dnn::readNetFromONNX 崩溃？
Ubuntu 官方源里的 OpenCV 默认关掉了 DNN 模块（因依赖 protobuf 版本冲突），readNetFromONNX 函数存在但内部是空实现，一调就段错误。
实操建议：
- 别信
apt list | grep opencv显示的版本号，运行pkg-config --modversion opencv4后再查pkg-config --cflags --libs opencv4，看输出里有没有-lopencv_dnn - 临时验证：写一行
std::cout << cv::dnn::dnn4v202307::getVersionString() << std::endl;，如果编译不过或运行时报undefined symbol，就是没开 DNN - 稳妥做法：自己用 CMake +
-D OPENCV_DNN=ON -D WITH_PROTOBUF=ON从源码编译，别省这十几分钟
CMakeLists.txt 里 find_package(OpenCV REQUIRED) 找不到你刚编译好的 OpenCV
find_package 默认只查系统路径和 CMAKE_PREFIX_PATH，不会自动扫描你 make install 到 /opt/opencv4 这种自定义位置。
实操建议：
- 安装时用
cmake -DCMAKE_INSTALL_PREFIX=/opt/opencv4 ...，之后在项目 CMakeLists.txt 顶部加：set(CMAKE_PREFIX_PATH "/opt/opencv4") - 或者更通用：编译项目时传参：
cmake -DOpenCV_DIR=/opt/opencv4/share/opencv4/cmake ..（注意路径要到cmake子目录） - 验证是否生效：在
find_package后加message(STATUS "OpenCV_FOUND = ${OpenCV_FOUND}")，避免静默 fallback 到旧版本
最容易被忽略的是：不同 OpenCV 版本生成的 OpenCVConfig.cmake 里硬编码了 OpenCV_VERSION 和 OpenCV_INCLUDE_DIRS，一旦路径写错半格，CMake 就会加载系统自带的老版本，而且不报错。
