Qt Creator 引入第三方库 OpenCV 配置指南

# =================================================================== # OpenCV Configuration # =================================================================== 
# $$PWD 代表.pro 文件所在目录，../ 向上追溯至 3rdparty 目录
INCLUDEPATH += $$PWD/../3rdparty/opencv/include

CONFIG(debug, debug|release) {
    # Debug 模式
    LIBS += -L$$PWD/../3rdparty/opencv/lib -lopencv_world320d
} else {
    # Release 模式
    LIBS += -L$$PWD/../3rdparty/opencv/lib -lopencv_world320
}

说明：

• $$PWD/../3rdparty/opencv/lib: 使用相对路径，确保项目迁移后路径依然有效。
• CONFIG(debug, debug|release): 根据构建模式自动选择对应的库文件。
• -L: 指定库文件目录。
• -l: 指定库名称（去掉前缀和后缀）。

编辑完成后，务必执行 Run qmake 使配置生效。

三、编写代码并编译

3.1 修改 main.cpp

添加 OpenCV 头文件并调用简单函数验证集成效果：

// main.cpp
#include "widget.h"
#include <QApplication>
#include <opencv2/opencv.hpp>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    
    // 测试代码：创建一个 OpenCV 窗口
    cv::namedWindow("open cv");
    
    Widget w;
    w.show();
    return a.exec();
}

3.2 编译项目

点击编译按钮。若配置正确，应能通过编译且无链接错误。

四、运行与问题排查

编译成功后，直接运行可能会遇到'丢失 opencv_world320d.dll'的错误。这是因为动态链接库需要在运行时被加载。

4.1 问题根源

编译器通过 .lib 文件确认函数存在，但程序运行时操作系统需要找到 .dll 文件。默认搜索路径通常不包含项目自定义的 3rdparty/bin 目录。

4.2 解决方案

方案一：手动复制 DLL

将对应的 .dll 文件复制到可执行文件所在的 debug 或 release 构建目录。此方法简单但每次清理项目后需重复操作。

方案二：配置运行环境

在 Qt Creator 的 Projects -> Build & Run -> Run 标签页中，设置 Working directory 为存放 DLL 的目录（如 3rdparty/opencv/bin）。此方法仅在 IDE 内运行有效。

方案三：编写构建后脚本（推荐）

修改 .pro 文件，利用 QMAKE_POST_LINK 在编译后自动复制 DLL 到输出目录：

# Post-build step: Copy DLLs
defineTest(copy_dll) {
    QMAKE_POST_LINK += $$quote(cmd /c copy /y $$shell_path($$1) $$shell_path($$2))
    return(true)
}

DLL_SOURCE_DIR = $$PWD/../3rdparty/opencv/bin
DEST_DIR = $$OUT_PWD

CONFIG(debug, debug|release) {
    copy_dll($$DLL_SOURCE_DIR/opencv_world320d.dll, $$DEST_DIR)
} else {
    copy_dll($$DLL_SOURCE_DIR/opencv_world320.dll, $$DEST_DIR)
}

此方案自动化程度高，适合发布部署。

总结

本文介绍了在 Qt Creator 中集成 OpenCV 的完整流程：

1. 规范目录结构：分离源码与依赖，提高可移植性。
2. 精确配置.pro：使用相对路径和条件编译区分 Debug/Release。
3. 解决 DLL 问题：理解运行时加载机制，推荐使用构建后脚本自动处理。

掌握此方法同样适用于其他第三方 C++ 库的集成。