Windows上Qt配置OpenCV的詳細教程(避坑必看)

更新時間：2025年02月11日 09:31:02 作者：kdnnnd

這篇文章詳細介紹了在Windows上使用Qt配置OpenCV的步驟,包括軟件安裝、環(huán)境變量配置、Qt項目配置以及通過創(chuàng)建pri文件簡化OpenCV庫的添加過程,并提供了一個簡單的測試案例來驗證配置是否成功,需要的朋友可以參考下

1 前言

博主為了在qt上配置OpenCV踩了很多坑,經(jīng)過一番努力,終于找到了最容易配置的方法,在這里總結(jié)出了一份經(jīng)驗,給有需要的人提供一點幫助。

2 軟件安裝

2.1 安裝qt

需要一個賬號,注冊后方可下載

qt官網(wǎng)

在這里插入圖片描述

2.2 安裝OpenCV(vc版)

注意32位還是64位

選擇Windows下載,接著一路next即可,這里下載的是msvc編譯的版本

OpenCV官網(wǎng)

在這里插入圖片描述

2.2.1 配置環(huán)境變量

OpenCV的使用需要配置環(huán)境變量,我將msvc版本配置了,可以按照自己安裝的路徑來配置

將bin文件夾放環(huán)境變量

msvc:
C:\OpenCV_s\opencv_vc\opencv\build\bin
C:\OpenCV_s\opencv_vc\opencv\build\x64\vc15\bin
C:\OpenCV_s\opencv_vc\opencv\build\x64\vc15\lib
mingw:
C:\OpenCV_s\OpenCV-MinGW-Build-OpenCV-3.4.8-x64\x64\mingw\bin

在這里插入圖片描述

3 Qt配置OpenCV

3.1 創(chuàng)建一個項目(注意選擇的是MinGW編譯器還是MSVC編譯器)

在pro文件中添加一些東西,根據(jù)自己選擇的編譯器,來添加,這里換成自己安裝的路徑

msvc:

INCLUDEPATH +=C:\OpenCV_s\opencv_vc\opencv\build\include\
              C:\OpenCV_s\opencv_vc\opencv\build\include\opencv\
              C:\OpenCV_s\opencv_vc\opencv\build\include\opencv2

LIBS +=C:\OpenCV_s\opencv_vc\opencv\build\x64\vc15\lib\opencv_world3414.lib 
或 C:\OpenCV_s\opencv_vc\opencv\build\x64\vc15\lib\opencv_world3414d.lib
注意: opencv_world3414d.lib 為debug版,opencv_world3414.lib為release版

4 簡單快捷添加OpenCV庫的方法

創(chuàng)建pri文件,將下方內(nèi)容寫入,同樣設置為自己安裝的路徑,文件可以放在任何位置,但建議放在安裝OpenCV的路徑下,方便自己查找.

INCLUDEPATH += C:/OpenCV_s/opencv_vc/opencv/build/include

Debug: {
    LIBS += -lC:/OpenCV_s/opencv_vc/opencv/build/x64/vc15/lib/opencv_world3414d
}

Release: {
    LIBS += -lC:/OpenCV_s/opencv_vc/opencv/build/x64/vc15/lib/opencv_world3414
}

之后在項目pro文件中添加下面這一行即可,不需要再添加那么多行,我這里pri文件放在下面的路徑里,設置為自己放的路徑,添加后qtcreator會自動添加到項目中:

include(C:\OpenCV_s\opencv.pri)

5 簡單案例,測試是否安裝成功

本例子使用的MSVC編譯的OpenCV

5.1 創(chuàng)建一個控制臺窗口

在這里插入圖片描述

5.2 注意選擇編譯器

我是自己設置的MSVC64位編譯器,一般來說qt安裝時選了MSVC編譯器就可以使用,不需要自己再設置,所以直接選擇MSVC相應的版本即可

在這里插入圖片描述

5.3 添加pri文件路徑

在這里插入圖片描述

main.cpp文件內(nèi)容:

#include <QCoreApplication>
#include "opencv2/opencv.hpp"
int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    using namespace cv;

    Mat image=imread("C:/test/1.jpeg");//改成自己圖片的路徑,注意使用的是'/'
    imshow("Output",image);
    return a.exec();
}