不用VS也能玩转OpenCV！QT5+MinGW环境下的OpenCV3.4.1配置教程

原创

于 2026-03-03 10:00:33 发布 · 922 阅读

不用VS也能玩转OpenCV！QT5+MinGW环境下的OpenCV3.4.1配置实战

很多C++开发者，尤其是做图形界面或跨平台应用的朋友，对QT情有独钟。它那优雅的信号槽机制、丰富的控件库以及良好的跨平台特性，让开发体验相当顺畅。然而，当我们想在QT项目中引入强大的计算机视觉库OpenCV时，一个常见的“拦路虎”就出现了：官方预编译的OpenCV库通常是针对微软的MSVC编译器构建的，而很多QT开发者习惯使用其自带的MinGW编译器。这两者不兼容，直接链接会报出一堆令人头疼的链接错误。难道为了用OpenCV，就必须放弃MinGW，转投Visual Studio的怀抱吗？当然不。今天，我们就来彻底解决这个问题，手把手带你从源码开始，在纯QT5+MinGW的环境下，构建并配置属于你自己的OpenCV 3.4.1，让你在不离开熟悉开发环境的前提下，畅享图像处理的乐趣。

这个过程的核心在于CMake。CMake是一个强大的跨平台构建系统生成器，它能读取我们编写的CMakeLists.txt配置文件，然后为当前平台和编译器生成对应的构建文件（比如Makefile或Visual Studio的.sln文件）。我们的策略就是：利用CMake，将OpenCV的源码，用MinGW编译器重新编译一遍，生成完全兼容的库文件。这听起来有点复杂，但跟着步骤走，你会发现它其实是一条清晰、可控的路径。本文面向的是有一定C++和QT基础，但可能对库的编译链接过程感到陌生的开发者。我们将不仅告诉你每一步怎么做，还会解释为什么这么做，让你真正理解环境配置背后的原理，未来遇到类似问题也能举一反三。

1. 环境准备与软件获取

工欲善其事，必先利其器。在开始编译之前，我们需要准备好所有必要的工具和源码。这个过程有点像准备一顿大餐的食材，缺一不可。

1.1 核心软件安装

首先，你需要确保系统中已经安装了以下三个核心组件：

QT 5.12+ 及 MinGW 编译器套件 这是我们的开发主环境。建议通过QT官方维护的镜像站点（如清华镜像）下载QT在线安装器。在安装过程中，最关键的一步是勾选MinGW编译器。通常，QT安装包会捆绑特定版本的MinGW（例如mingw73_32或mingw81_64）。请根据你的系统架构（32位或64位）选择，并确保安装。安装完成后，QT Creator应该能自动检测到该编译器。

注意：请记录下你的MinGW编译器的完整安装路径，例如 C:\Qt\Tools\mingw730_64\bin。后续的CMake配置和编译命令都会用到它。
CMake 3.10+ 前往CMake官网下载最新稳定版的安装程序。安装时，有一个便利的选项是“Add CMake to the system PATH for all users”，务必勾选它。这样，你就可以在任意命令行窗口中直接使用cmake命令了。安装完成后，可以在命令行输入 cmake --version 来验证是否安装成功。
OpenCV 3.4.1 源码 从OpenCV官网的发布页面，找到3.4.1版本，下载其源代码包（通常是 opencv-3.4.1.zip 或 opencv-3.4.1.tar.gz）。请务必下载源码（Source），而不是已经编译好的Windows包（那个是针对MSVC的）。下载后，将其解压到一个没有中文和空格的路径下，例如 D:\Libs\opencv-3.4.1。