### Qt 和 CMake 项目中 OpenCV 链接错误解决方案 在处理 `undefined reference` 错误时，通常意味着链接器无法找到特定函数的实现。对于 `cv::Mat::Mat()` 的未定义引用问题，在构建过程中需要确保正确配置了 OpenCV 库。 #### 正确设置库路径和依赖项 当遇到此类链接错误时，确认已将必要的 OpenCV 库文件添加到项目的链接选项中[^2]。例如： ```cmake target_link_libraries(${PROJECT_NAME} ${OpenCV_LIBS} /home/pi/opencv-4.5.5/build/lib/libopencv_core.so /home/pi/opencv-4.5.5/build/lib/libopencv_imgproc.so /home/pi/opencv-4.5.5/build/lib/libopencv_highgui.so /home/pi/opencv-4.5.5/build/lib/libopencv_imgcodecs.so ) ``` 上述代码片段展示了如何通过指定绝对路径来显式链接所需的 OpenCV 动态库文件。这有助于防止由于默认搜索路径缺失而导致的链接失败情况发生。 #### 使用 FindPackage 查找并加载 OpenCV 为了简化跨平台开发过程中的依赖管理，推荐利用 CMake 提供的 `find_package(OpenCV)` 命令自动检测系统中存在的 OpenCV 安装位置及其组件列表[^4]。之后可以直接引用变量 `${OpenCV_LIBRARIES}` 来代替手动罗列各个子模块的名字。 ```cmake find_package(OpenCV REQUIRED core imgproc highgui imgcodecs) if (OpenCV_FOUND) include_directories(${OpenCV_INCLUDE_DIRS}) target_link_libraries(${PROJECT_NAME} PRIVATE ${OpenCV_LIBRARIES}) endif() ``` 这段脚本会尝试定位本地安装好的 OpenCV 版本，并将其头文件目录以及静态或共享库添加至目标可执行程序之中。 #### 确认编译环境一致性 如果正在使用 MinGW 工具链，则需要注意不同版本间的兼容性差异。某些预编译二进制包可能仅支持特定类型的编译器组合；因此建议针对所选工具集自行编译适合当前系统的 OpenCV 源码。 另外还需注意的是，若采用多线程或多处理器架构下的优化特性（如 TBB），则应相应调整 CMakeLists.txt 文件内的参数设定以匹配实际需求。 #### 更新软件包索引并重试安装 有时简单的更新操作就能解决问题。可以通过运行以下命令刷新 APT 软件源缓存并再次尝试获取最新版 OpenCV 开发套件[^3]: ```bash sudo apt-get update && sudo apt-get install --reinstall libopencv-dev ``` 此方法适用于基于 Debian 或 Ubuntu Linux 发行版的情况。