1.QT環境變量配置
在Qt中配置OpenCV 3.4.6與Visual Studio 2017的步驟如下：
一、前期準備
-
安裝組件驗證
-
確認已安裝Qt的MSVC2017版本（如Qt 5.12+ MSVC2017 64-bit）
-
檢查Visual Studio 2017的MSVC編譯器是否正常工作
-
OpenCV庫準備
-
從官網下載預編譯包：選擇
opencv-3.4.6-vc14_vc15.exe（vc15對應VS2017） -
解壓到無空格路徑（例如
D:\Libs\opencv346）
二、環境變量配置
-
添加系統變量：
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() << "加載圖片失敗！";}
}
常見問題解決
-
鏈接錯誤 LNK2019
-
檢查庫文件路徑是否正確
-
確認Debug/Release模式匹配（d后綴版用于Debug）
-
運行時缺失DLL
-
確保環境變量生效（可能需要重啟Qt Creator）
-
檢查exe目錄是否包含所需DLL
-
頭文件找不到
-
驗證INCLUDEPATH中的斜杠方向（建議使用
/代替\） -
檢查OpenCV版本號是否匹配（346對應3.4.6）
建議使用CMake管理項目時，可通過find_package(OpenCV REQUIRED)自動配置路徑。
當前路徑 # 包含路徑（根據實際路徑修改） INCLUDEPATH += $$PWD/includeINCLUDEPATH += $$PWD/include/opencv2 ? # 庫路徑 ?# Release模式LIBS += -L$$PWD/lib/ -lopencv_world346
