VS2022 + QT + OpenCV 环境配置教程
通过以上步骤,你已经成功在 VS2022 中配置了 QT 和 OpenCV 环境,并进行了简单的测试。这样你就可以在 Visual Studio 2022 中利用 QT 的图形界面开发能力和 OpenCV 的计算机视觉功能进行项目开发了。在实际开发过程中,可能会遇到各种问题,例如库文件链接错误、版本不兼容等,需要耐心排查和解决。希望本文对你有所帮助,祝你开发顺利!请注意,以上路径和文件名根据实际安
在计算机视觉和图形界面开发领域,Visual Studio 2022(VS2022)、QT 和 OpenCV 都是非常强大且常用的工具。VS2022 提供了一个功能强大的集成开发环境,QT 用于构建跨平台的图形用户界面,OpenCV 则专注于计算机视觉任务。本文将详细介绍如何在 VS2022 中配置 QT 和 OpenCV 环境,让你能够快速开启相关项目的开发。
一、准备工作
-
下载安装 Visual Studio 2022:
- 前往微软官网下载 Visual Studio 2022 安装包。
- 在安装过程中,确保勾选 “使用 C++ 的桌面开发” 工作负载,这将安装 C++ 开发所需的基本组件。
-
下载安装 QT:
- 访问QT 官网,根据你的操作系统下载合适的 QT 安装包。
- 运行安装程序,按照提示进行安装。在安装过程中,可以选择安装所需的 QT 版本和组件。建议安装最新的 LTS(长期支持)版本,以获得更稳定的性能和更长时间的支持。
-
下载 OpenCV:
- 从OpenCV 官网下载 OpenCV 的源代码或预编译库。对于初学者,建议下载预编译库,这样可以减少编译的复杂性。选择与你的操作系统和 Visual Studio 版本兼容的 OpenCV 版本。例如,如果你使用的是 Visual Studio 2022,建议选择 OpenCV 4.x 系列版本。
二、配置 QT 环境
-
安装 QT Visual Studio Tools:
- 打开 Visual Studio 2022。
- 选择 “扩展” -> “管理扩展”。
- 在弹出的窗口中,搜索 “QT Visual Studio Tools”,然后点击 “下载” 进行安装。安装完成后,重启 Visual Studio 2022。
-
设置 QT 选项:
- 打开 Visual Studio 2022,选择 “QT” -> “QT Options”。
- 在 “QT 选项” 对话框中,点击 “QT 版本” 选项卡。
- 点击 “添加” 按钮,浏览到 QT 安装目录下的
bin\qmake.exe文件,例如C:\Qt\{版本号}\mingw{位数}\bin\qmake.exe,然后点击 “确定”。 - Visual Studio 会自动检测并添加 QT 版本信息。
三、配置 OpenCV 环境
-
解压 OpenCV 压缩包:
将下载的 OpenCV 压缩包解压到你希望的安装目录,例如C:\opencv。 -
设置系统环境变量:
- 右键点击 “此电脑”,选择 “属性”。
- 在弹出的窗口中,点击 “高级系统设置”。
- 在 “系统属性” 对话框中,点击 “环境变量” 按钮。
- 在 “系统变量” 区域中,找到 “Path” 变量,点击 “编辑”。
- 在 “编辑环境变量” 对话框中,点击 “新建”,添加 OpenCV 安装目录下的
build\x64\vc15\bin路径(如果使用的是 Visual Studio 2019,则是build\x64\vc14\bin),例如C:\opencv\build\x64\vc15\bin。点击 “确定” 保存更改。
-
在 Visual Studio 中配置 OpenCV:
- 打开 Visual Studio 2022,创建一个新的 C++ 项目(例如 “空项目”)。
- 右键点击项目名称,选择 “属性”。
- 在 “属性页” 对话框中,选择 “VC++ 目录” -> “包含目录”。
- 点击 “编辑”,添加 OpenCV 安装目录下的
build\include路径及其子目录build\include\opencv2,例如C:\opencv\build\include和C:\opencv\build\include\opencv2。点击 “确定” 保存更改。 - 选择 “VC++ 目录” -> “库目录”。
- 点击 “编辑”,添加 OpenCV 安装目录下的
build\x64\vc15\lib路径(根据你的 Visual Studio 版本和 OpenCV 编译配置选择相应的路径),例如C:\opencv\build\x64\vc15\lib。点击 “确定” 保存更改。 - 选择 “链接器” -> “输入” -> “附加依赖项”。
- 在 “附加依赖项” 中添加 OpenCV 的库文件。根据你使用的 OpenCV 版本和编译配置,添加相应的
.lib文件。例如,对于 OpenCV 4.x 版本,常见的库文件有opencv_world455d.lib(调试版本)和opencv_world455.lib(发布版本)。这里的455是版本号,根据实际情况调整。
四、测试环境配置
- 创建一个简单的 QT + OpenCV 项目:
- 在 Visual Studio 2022 中,选择 “文件” -> “新建” -> “项目”。
- 在 “新建项目” 对话框中,选择 “QT” -> “QT Widgets Application”。输入项目名称并选择保存位置,然后点击 “确定”。
- 在项目中添加一个源文件(例如
main.cpp),编写以下测试代码:
cpp
#include <opencv2/opencv.hpp>
#include <QApplication>
#include <QLabel>
#include <QPixmap>
#include <QImage>
int main(int argc, char *argv[]) {
QApplication a(argc, argv);
// 使用 OpenCV 读取一张图片
cv::Mat image = cv::imread("C:\\test.jpg"); // 替换为你的图片路径
if (image.empty()) {
std::cout << "Could not open or find the image" << std::endl;
return -1;
}
// 将 OpenCV 的 Mat 转换为 QImage
QImage qImage((const uchar*)image.data, image.cols, image.rows, image.step, QImage::Format_BGR888);
// 在 QLabel 中显示图片
QLabel label;
label.setPixmap(QPixmap::fromImage(qImage));
label.show();
return a.exec();
}
- 运行项目:
- 将一张测试图片(例如
test.jpg)放置在指定路径下(上述代码中的C:\\test.jpg)。 - 选择 “调试” -> “开始执行(不调试)” 或直接按
Ctrl + F5运行项目。如果一切配置正确,你应该能够看到图片在 QT 窗口中显示出来。
- 将一张测试图片(例如
五、总结
通过以上步骤,你已经成功在 VS2022 中配置了 QT 和 OpenCV 环境,并进行了简单的测试。这样你就可以在 Visual Studio 2022 中利用 QT 的图形界面开发能力和 OpenCV 的计算机视觉功能进行项目开发了。在实际开发过程中,可能会遇到各种问题,例如库文件链接错误、版本不兼容等,需要耐心排查和解决。希望本文对你有所帮助,祝你开发顺利!
请注意,以上路径和文件名根据实际安装情况和版本可能会有所不同,请根据你的具体环境进行调整。同时,确保你下载的 QT、OpenCV 版本与 Visual Studio 2022 兼容,以避免不必要的问题。如果在配置过程中遇到任何问题,可以查阅相关文档或在技术论坛上寻求帮助。
火山引擎开发者社区是火山引擎打造的AI技术生态平台,聚焦Agent与大模型开发,提供豆包系列模型(图像/视频/视觉)、智能分析与会话工具,并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长,新用户可领50万Tokens权益,助力构建智能应用。
更多推荐

所有评论(0)