Qt 程序打包，运行提示找不到或无法加载平台插件 qwindows.dll

Blasit2026-03-26 9:28

一、前言

当我们使用Qt的打包指令windeployqt打包完程序时出现提示：

This application failed to start because no Qt platform plugin could beinitialized. Reinstalling the application may fix this problem.

Available platform plugins are: windows.

翻译就是找不到或无法加载平台插件 qwindows.dll，我这里的直接原因是程序从32位转成64位，然后直接运行CMD命令行使用windeployqt打包。

二、解决方案

1、最直接解决办法就是不要直接在系统 CMD 里运行 windeployqt，而是使用 Qt自带命令行环境，例如：

XML 复制代码

打开Qt 5.x for Desktop (MinGW) Command Prompt
或者Qt 5.x for Desktop (MSVC) Command Prompt

然后进入你的 exe 目录：
cd D:\QTSpace\testApp1
执行：
windeployqt testApp1.exe

2、如果上面的方式还不行，也可以手动复制，例如这里的路径为：

D:\Qt\5.15.2\mingw81_64\plugins\platforms\qwindows.dll

复制到D:\QTSpace\testApp1\platforms

三、其他技巧

1、release的快速打包指令，windeployqt --release --compiler-runtime app.exe，这个带参数的比不带参数的更加稳定和准确。

2、快速查找缺失的.dll文件，在命令行运行：

set QT_DEBUG_PLUGINS=1

app.exe

Qt 会打印插件加载失败原因。例如：Cannot load library qwindows.dll: 找不到 xxx.dll，就能看到具体缺哪个 DLL。

3、缩小程序体积的打包建议，windeployqt --release --no-angle --no-translations app.exe，特点是关闭 ANGLE（OpenGL兼容层QML、QOpenGLWidget、Qt Quick），不复制 Qt 翻译文件（QTranslator），然后再手动删除不用插件和用 UPX 压缩（upx --best MyApp.exe/*.dll），可以缩小打包完成后的程序目录大小。