qtcreater配置opencv遇到的坑及實踐記錄

更新時間：2025年05月26日 14:33:43 作者：六bring個六

我配置opencv不管是按照網(wǎng)上的教程還是deep seek發(fā)現(xiàn)都有些問題,下面是我的配置方法以及實踐成功的心得,感興趣的朋友跟隨小編一起看看吧

電腦環(huán)境

windows平臺

qt6

下載

我這里直接提供官網(wǎng)下載地址：https://opencv.org/releases/

我下載的是最新版，下載后是一個.exe文件，運(yùn)行他安裝到自己指定的路徑，我是在D盤下新建了一個目錄opencv，把他安裝到目錄下，文件結(jié)構(gòu)如下

D:\OpenCV
└── opencv
    ├── build           # 預(yù)編譯的庫和頭文件
    │   ├── include
    │   │   └── opencv2  
    │   └── x64
    │       └── vc16     # 對應(yīng) Visual Studio 2019/2022 的庫
    └── sources         # 源代碼（無需配置）

AI說什么在include文件下有一個什么opencv4，說我下的是老版本，這里是一個坑，新版的就是這樣的結(jié)構(gòu)，ai數(shù)據(jù)還待更新啊，繼續(xù)下一步

環(huán)境變量配置

Windows配置opencv是需要配置環(huán)境變量的，在opencv的安裝路徑按照我這樣的結(jié)構(gòu)去找路徑：

D:\Opencv\opencv\build\x64\vc16\bin

在系統(tǒng)環(huán)境和用戶環(huán)境的path都要配置，把路徑加進(jìn)去，不然在qt程序中include的時候會找不到庫文件的

qmake加入外部庫

在.pro文件最下面加上這幾句，注意路徑改成自己的，需要的dll文件在自己的路徑下找一找替換一下

win32:CONFIG(release, debug|release): LIBS += -LD:/Opencv/opencv/build/x64/vc16/lib/ -lopencv_world4110
else:win32:CONFIG(debug, debug|release): LIBS += -LD:/Opencv/opencv/build/x64/vc16/lib/ -lopencv_world4110d
INCLUDEPATH += D:/Opencv/opencv/build/include
DEPENDPATH += D:/Opencv/opencv/build/include

測試配置

我是臨時建了一個mianwindow項目，要注意下用msvc編譯，mingw好像操作有些不同，在main程序中加入測試代碼：

#include "mainwindow.h"
#include <QApplication>
#include"opencv2/opencv.hpp"
#include<iostream>
int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();
    // 打印 OpenCV 版本
    std::cout << "OpenCV Version: " << CV_VERSION << std::endl;
    return a.exec();
}

如果配置成功會輸出