11.OpenCV—联合QT环境配置

1.QT环境变量配置

在Qt中配置OpenCV 3.4.6与Visual Studio 2017的步骤如下：

一、前期准备

1. 安装组件验证

• 确认已安装Qt的MSVC2017版本（如Qt 5.12+ MSVC2017 64-bit）

• 检查Visual Studio 2017的MSVC编译器是否正常工作

1. OpenCV库准备

• 从官网下载预编译包：选择opencv-3.4.6-vc14_vc15.exe（vc15对应VS2017）

• 解压到无空格路径（例如D:\Libs\opencv346）

二、环境变量配置

1. 添加系统变量：

Path += D:\Libs\opencv346\build\x64\vc15\bin

三、Qt项目配置（.pro文件）

# 包含路径（根据实际路径修改）
INCLUDEPATH += D:/Libs/opencv346/build/includeD:/Libs/opencv346/build/include/opencv2
​
# 库路径
win32 {CONFIG(debug, debug|release) {# Debug模式LIBS += -LD:/Libs/opencv346/build/x64/vc15/lib \-lopencv_world346d} else {# Release模式LIBS += -LD:/Libs/opencv346/build/x64/vc15/lib \-lopencv_world346}
}

#相对路径# 包含路径（根据实际路径修改）
INCLUDEPATH += $$PWD/src/opencv/opencv/build/include
INCLUDEPATH += $$PWD/src/opencv/opencv/build/include/opencv2# 库路径# Release模式LIBS += -L$$PWD/src/opencv/opencv/build/x64/vc15/lib  -lopencv_world346

四、DLL文件处理

将以下文件复制到exe输出目录：

• opencv_world346.dll（Release版）

• opencv_world346d.dll（Debug版） 位于：opencv\build\x64\vc15\bin

五、验证测试代码

#include <QDebug>
#include <opencv2/opencv.hpp>
​
void testOpenCV()
{cv::Mat img = cv::imread("test.jpg");if(!img.empty()) {qDebug() << "OpenCV配置成功！图像尺寸：" << img.cols << "x" << img.rows;cv::imshow("Display", img);cv::waitKey(0);} else {qDebug() << "加载图片失败！";}
}

常见问题解决

1. 链接错误 LNK2019

• 检查库文件路径是否正确

• 确认Debug/Release模式匹配（d后缀版用于Debug）

1. 运行时缺失DLL

• 确保环境变量生效（可能需要重启Qt Creator）

• 检查exe目录是否包含所需DLL

1. 头文件找不到

• 验证INCLUDEPATH中的斜杠方向（建议使用/代替\）

• 检查OpenCV版本号是否匹配（346对应3.4.6）

建议使用CMake管理项目时，可通过find_package(OpenCV REQUIRED)自动配置路径。

当前路径
# 包含路径（根据实际路径修改）
INCLUDEPATH += $$PWD/includeINCLUDEPATH += $$PWD/include/opencv2
​
# 库路径
​# Release模式LIBS += -L$$PWD/lib/ -lopencv_world346