如何安装配置Qt适配OpenCV与Visual Studio 2022开发环境

一、修复"无法找到Kit"的报错 #

该问题本质是套件关联关系不匹配，哪怕配置页显示存在MinGW 2022套件，也大概率是组件缺装或路径映射失效，按以下步骤操作即可修复：

• 补装缺失组件：打开Qt安装根目录下的MaintenanceTool.exe，进入「添加或移除组件」页面，必须勾选三类组件：
  • 对应Qt版本（如Qt 6.7.3）分支下的MinGW 11.2.0 64-bit（和你看到的MinGW 2022版本对应，不要选MSVC或其他架构版本）
  • Developer and Designer Tools分支下的MinGW 11.2.0 64-bit、Qt Creator、CMake、Ninja

  最常见的踩坑点：只安装了Qt的预编译库，没装Tools分类下的匹配版本MinGW，就会出现列表显示套件但实际无法调用的问题。

• 重置套件关联：打开Qt Creator，点击顶部菜单工具 > 选项 > Kits：
  1. 先切到「编译器」标签页，确认自动识别到的MinGW g++/gcc路径指向Qt安装目录下的Tools/mingw1120_64/bin/g++.exe，识别失败就手动添加该路径
  2. 再切到「Qt Versions」标签页，确认qmake路径指向Qt/[你的版本号]/mingw_64/bin/qmake.exe，条目旁无黄色感叹号
  3. 切回「Kits」标签页，选中列表里的MinGW 2022套件，将下拉项里的编译器、Qt版本、调试器全部选为前两步确认过的匹配项，点击应用
• 验证套件可用性：新建一个最简Qt Widgets项目，选中配置好的MinGW套件，点击左下角构建运行按钮，能正常弹出空白窗口即说明Kit问题修复完成。

二、对接现有OpenCV人脸检测项目 #

你之前在VS Code中写的人脸检测、ROI保存逻辑不需要重写，按以下步骤对接Qt界面即可：

• 确认OpenCV库版本匹配：如果你之前在VS Code中用的是MSVC编译的OpenCV，必须替换为和Qt自带MinGW同版本编译的OpenCV库，否则链接阶段会报大量符号缺失错误。
• 项目文件配置：在Qt项目的.pro配置文件中添加OpenCV关联配置，路径替换为你本地的OpenCV安装路径：

INCLUDEPATH += D:/opencv/build/include
LIBS += D:/opencv/build/x64/mingw/lib/libopencv_*.a

• 功能对接逻辑：将原有的人脸检测、ROI保存核心代码迁入Qt项目，OpenCV的VideoCapture视频捕获逻辑放在子线程运行，避免阻塞界面；捕获到的帧转成QImage格式发送给主界面显示，新增的强制捕获按钮直接绑定原有ROI保存逻辑即可。

常见问题规避 #

• 所有环节使用的MinGW版本必须完全一致：Qt自带MinGW、编译OpenCV的MinGW版本号要完全对应，不要混用自己单独安装的其他版本MinGW，否则会出现随机运行崩溃、链接失败等问题。
• 调试阶段选择Debug构建模式，发布时再切换Release模式，不要在Debug模式下链接Release版本的库文件。
• 如果反复调整套件配置仍报错，直接删除C:/Users/[你的用户名]/AppData/Roaming/QtProject文件夹，重启Qt Creator后会自动重新识别所有本地套件，比手动调整效率更高。

内容的提问来源于stack exchange，提问作者Aoi Hyoudou