静态链接带Qt选项的OpenCV可执行文件Qt平台插件初始化失败求助

• 已通过vcpkg构建带Qt选项的OpenCV 4.8.0静态库，安装命令：

  vcpkg.exe install opencv[ade,contrib,default-features,dnn,eigen,ffmpeg,freetype,gdcm,jasper,jpeg,lapack,nonfree,openexr,opengl,openmp,ovis,png,python,qt,quirc,sfm,tbb,tiff,vtk,vulkan,webp]:x64-windows-static --recurse
  

• 使用Visual C++ 2019创建Win32 API应用，成功链接生成独立可执行文件，cv::imread()可正常读取图像，但调用cv::imshow()时弹出错误：

  This application failed to start because no Qt platform plugin could be initialized.
  

• 尝试用windeployqt处理，命令：

  \vcpkg\installed\x64-windows-static\tools\Qt6\bin\windeployqt.exe --debug --compiler-runtime "\Projects\Test\appName\x64\Debug\appName.exe"
  

  工具报错：

  \Projects\Test\appName\x64\Debug\appName.exe does not seem to be a Qt executable.

• 手动复制\vcpkg\installed\x64-windows-static\Qt6\plugins\platforms目录到可执行文件及项目文件夹，问题依旧。
• 代码未直接使用Qt，仅OpenCV依赖Qt，无意学习Qt开发。
• 已在项目属性->调试->环境中设置PATH：

  PATH=%PATH%;D:\vcpkg\installed\x64-windows-static\tools\Qt6\bin\;D:\vcpkg\installed\x64-windows-static\Qt6\plugins\;D:\vcpkg\installed\x64-windows-static\Qt6\plugins\platforms\;
  

方案1：重新构建不带Qt的OpenCV静态库 #

既然无需Qt功能，直接移除OpenCV的Qt选项重新安装，彻底避免Qt依赖问题：

vcpkg.exe install opencv[ade,contrib,default-features,dnn,eigen,ffmpeg,freetype,gdcm,jasper,jpeg,lapack,nonfree,openexr,opengl,openmp,ovis,png,python,quirc,sfm,tbb,tiff,vtk,vulkan,webp]:x64-windows-static --recurse

此时OpenCV会使用Win32原生窗口作为HighGUI后端，cv::imshow()可正常运行。

方案2：手动配置Qt插件路径（需保留Qt选项时） #

如果必须使用OpenCV的Qt相关功能，需让程序正确定位Qt平台插件：

1. 在可执行文件目录下创建platforms文件夹，将\vcpkg\installed\x64-windows-static\tools\Qt6\plugins\platforms\qwindows.dll（Debug版本用qwindowsd.dll）复制到该文件夹。
2. 将Qt核心DLL（Qt6Core.dll、Qt6Gui.dll、Qt6Widgets.dll，Debug版本带d后缀）从\vcpkg\installed\x64-windows-static\tools\Qt6\bin复制到可执行文件目录，或确保该bin目录在系统PATH中。
3. 在代码开头手动指定Qt插件路径（无需直接调用Qt API）：

   #include <opencv2/opencv.hpp>
   #include <cstdlib>
   
   int main() {
       // 替换为你的实际Qt插件路径
       setenv("QT_QPA_PLATFORM_PLUGIN_PATH", "D:\\vcpkg\\installed\\x64-windows-static\\Qt6\\plugins\\platforms", 1);
       // Windows平台也可使用：SetEnvironmentVariableA("QT_QPA_PLATFORM_PLUGIN_PATH", "你的路径");
   
       cv::Mat img = cv::imread("test.jpg");
       cv::imshow("Image", img);
       cv::waitKey(0);
       return 0;
   }
   

   注意Debug和Release版本的插件、DLL要对应，避免混用。

方案3：补全Qt静态库链接（静态编译场景） #

vcpkg的x64-windows-static是静态编译模式，若项目未链接Qt的静态库，会导致插件加载失败。需在项目属性->链接器->输入->附加依赖项中添加：

• Release版本：Qt6Core.lib、Qt6Gui.lib、Qt6Widgets.lib等
• Debug版本：Qt6Cored.lib、Qt6Guid.lib、Qt6Widgetsd.lib等

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