Qt Creator 引入第三方库 OpenCV 配置指南
引言
在软件开发中,集成第三方库是常见需求。对于使用 Qt 框架的 C++ 开发者,掌握如何高效地将 OpenCV(计算机视觉库)集成到项目中是一项核心技能。本教程将演示如何将 OpenCV 库集成到 Qt Widgets 项目中,解决路径配置、链接器错误及运行时 DLL 丢失等问题。
一、准备工作
1.1 获取并安装 OpenCV
从 OpenCV 官方网站下载适用于 Windows 的预编译版本。解压后,核心内容位于 build 子目录:
opencv/build/include: 存放头文件(.h,.hpp)。opencv/build/x64/vc15/lib: 存放链接库文件(.lib),包含 Release 和 Debug 版本。opencv/build/x64/vc15/bin: 存放运行时依赖的动态链接库(.dll)。
1.2 创建新的 Qt 项目
打开 Qt Creator,创建新项目:
File->New Project- 选择
Application (Qt)->Qt Widgets Application - 命名项目(如
testqt),选择构建系统为qmake - 保持默认设置完成创建
1.3 建立专业的项目目录结构
建议采用源码与依赖分离的结构,以增强可移植性。假设项目根路径为 D:/MyProjects/testqt/,结构如下:
D:/MyProjects/
|-- 3rdparty/
| |-- opencv/
| |-- include/ (OpenCV 头文件)
| |-- lib/ (OpenCV .lib 文件)
| |-- bin/ (OpenCV .dll 文件)
|-- testqt/ (Qt 项目目录)
|-- testqt.pro
|-- main.cpp
|-- widget.h
|-- widget.cpp
|-- widget.ui
将 OpenCV 解压后的对应文件复制到 3rdparty/opencv/ 下对应的文件夹中。
二、配置.pro 文件
.pro 文件是 Qt 项目的核心,需配置头文件路径 (INCLUDEPATH) 和库文件路径 (LIBS)。
2.1 方式一:图形化向导
右键点击项目根节点,选择 Add Library...,添加外部库。注意勾选平台限制,取消自动添加 debug 后缀选项,以便手动控制。
2.2 方式二:手动编辑.pro 文件(推荐)
手动编辑能更好地控制相对路径和调试模式区分。在 末尾添加以下代码:


