Qt5 QML程序Release版本发布程序无法显示的问题解决过程

最新推荐文章于 2025-05-20 15:33:15 发布
最新推荐文章于 2025-05-20 15:33:15 发布
阅读量1.9k 收藏 4
点赞数 1
CC 4.0 BY-SA版权
分类专栏： QT Relese Tool 文章标签： Qml 发布问题
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/CLinuxF/article/details/85112119
本文详细记录了一位开发者在使用QT 5.9.7和QTquickcontrol2.0版本进行QML程序开发时遇到的程序打包后无法运行的问题，并分享了解决方案，包括调整目录结构及替换特定DLL文件。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

一：先解析下我的环境：

1：QT平台： qt-opensource-windows-x86-5.9.7

2：系统：Win10 64位平台

3：使用QT quick control 2.0 版本

4：本程序的名字位 gadget.exe

5：打包命令：windeployqt gadget.exe -qmldir D:\FL\Qt\Qt5.9.7\5.9.7\mingw53_32\qml
在这里插入图片描述

6：本程序使用windeployqt打包的目录如下：
在这里插入图片描述
二：现象

1：使用QML页面开发，没有使用特殊的硬件。

2：在QT Creator 中正常运行，正常显示。

3：使用windeployqt的打包工具打包后直接双击运行程序

4：完全没有任何反应，不报错也没有提示，就好像没有点击过一样。

5: 如果将程序放在 QT的MinGW环境下又能正常运行，我这边的QT路径是：D:\Qt\Qt5.9.7\5.9.7\mingw53_32\bin

三：结论

如果开发的QML程序运行没显示，可以尝试下列解决方法：

1：把windeployqt打包后的目录移到程序的上一层目录里。(非必须)

2：如果是基于mingw的程序，记得把windeployqt打包的Qt5Core.dll文件替换为MinGW的bin目录里的同名文件。(必须)

程序运行起来界面：
在这里插入图片描述

参考于：https://blog.youkuaiyun.com/jhkdiy/article/details/65443782

更新时间2019年6月10日 17:09:57
主要更新一个可以查看软件依赖的dll相关的软件，我发现qt自带的打包太冗余了，基本有一半大小可以手动去掉，完全不影响程序启动，这里提供下这个软件的下载链接：

可视化dll依赖软件下载

【Qt 的“前世”与“今生”】Qt 的起源 | Qt 的发展历程 | 为什么选择 Qt | Qt 的授权模式 | Qt 版本选择 | Qt Widgets和QML | Qt 程序发布
dvlinker的技术专栏
12-03 2万+
【 Qt 的“前世”与“今生”】Qt 的起源 | Qt 的发展历程 | 为什么选择 Qt | Qt 的授权模式 | Qt 版本选择 | Qt Widgets和QML | Qt 程序发布
QT/QML程序打包发布问题
sucaptain的博客
03-03 684
QT程序开发完成时，一般使用windeployqt工具打包exe文件运行需要的库。但是如果是QtQuick项目，使用qml文件，在打包时还需要加上--qmldir参数。并根据选择编译器版本选择对应的qml环境路径。但是对于某些qml模块，windeployqt可能无法找到和复制。这样可能情况造成在开发环境可以正常运行，但是在其他环境就界面异常或崩溃。对于这些qml模块可能需要自己手动复制。发现Qt.labs.platform模块没有加载成功。
Qt Qt Quick QML 打包发布程序出现缺少dll，窗体空白，点击后无反应等发布不成功的终极解决方法
keanight的博客
01-27 3893
在发布 Qt 应用或 QML（Qt Quick）应用时经常出现缺少各种dll插件，窗体空白，点击程序没有反应或者程序运行时图片等其它资源加载不正常等问题，寻找程序依赖的文件是一个极其麻烦的事情，所以可以采用以下终极方法。 新建一个空白文件夹，作为最终发布程序的文件夹在 Qt Creator 中生成 release 版本的exe文件，将app.exe拷贝到发布文件夹将编写程序用到的第三方d
Qt5 QML程序Release版本发布程序无法显示但任务管理器中进程存在的问题解决过程。
qq_33425353的博客
09-14 669
Qt5 QML程序Release版本发布程序无法显示的问题解决过程。   使用windeployqt打包完qml程序后点击运行，程序无显示，但在任务管理中可以看到进程存在，解决办法为：   用mingw的bin目录的Qt5Core.dll文件替换打包文件里的t5Core.dll，可以解决问题！   参考连接： https://blog.youkuaiyun.com/jhkdiy/article/d...
Windows下使用Windeployqt.exe打包后运行exe程序报错0xc000007b问题解决方法
最新发布
qq_38220144的博客
05-20 311
在使用windeployqt打包QT程序时，若遇到程序无法正常启动（错误代码0xc000007b），通常是由于本机安装了多个版本的Qt（包括32位和64位），导致环境变量冲突。解决方法是使用指定版本的windeployqt.exe进行打包。具体步骤为：首先确定开发程序所使用的Qt版本，然后进入该版本的Qt命令行工具。如果开始菜单中找不到命令行工具，可以手动进入Qt安装目录并打开命令行。最后，在命令行中输入windeployqt.exe并指定目标exe文件的路径进行打包。这样可以确保打包过程中使用正确的Qt版
Qt5 QML程序Release版本发布程序无法显示的问题解决过程。
qq_40110291的博客
05-12 864
一：先解析下我的环境： 1：QT平台： qt-opensource-windows-x86-mingw530-5.7.1 2：系统：Win7 64位平台 3：使用QT quick control 2.0 版本 4：本程序的名字位 Btc.exe 5：本程序使用windeployqt打包的目录如下：   二：现象 1：使用QML页面开发，没有使用特殊的硬件。 2：在QT Crea...
Windows下发布Qt5.12.3的qml程序
joyopirate的博客
06-10 1002
Windows下发布Qt5.12.3的qml程序
发布QML程序
gigizhongyan的专栏
04-10 434
windeployqt untitled2.exe -qmldir E:\Qt\Qt5.8.0\5.8\msvc2015\qml F:\UsbReaderHdQML\build-UsbReaderNew-Desktop_Qt_5_11_3_MSVC2015_32bit-Release\release\UsbReader.exeD:\Qt\Qt5.11.3\5.11.3\msvc...
Qt QML打包遇到的问题记录
Juan_Luo的博客
11-12 356
这一时半会就没辙了，后面又重新检查了Qt发布目录中的程序是可以正常运行的，单独复制到打包目录后在没运行windeployqt6之前也是可以正常运行的，问题就出在windeployqt6运行之后。莫非要填这个文件的路径才对？然后再查，发现QML的打包还需要多加一个-qmlir命令，后面接一个qml路径，但是网上说的不够清楚，翻了一下文件夹在Qt安装目录里翻到一个qml文件夹，扔进去打包。然后打包目录确实多了很多文件，然后赶紧双击程序看能不能运行，结果是不行，唯一的反应就是鼠标转了一秒，然后就没然后了。
step11:打包qml程序
summer__7777的博客
08-09 357
电脑里安装了两个版本的QT，最好把现在打包的QT版本环境变量移到最前面添加完成环境变量之后，再在windos打开qt 6.4.3（minGW）命令框，这里需要与编译release版本的编译器对应。
Qt程序发布
taozismallmarket的博客
05-12 309
2.若为cmake程序，在add_executable中添加WIN32, 如:add_executable(target WIN32 files) ,消除运行程序产生的黑窗口。1.使用QT自带bat windeployqt xxx.exe --qml “qmldir” --release(若使用qml需要指定qml路径，否则程序运行闪退)
qml程序发布操作方法
大樹bigtree的博客
10-03 1630
Qt Creator创建工程后，编译出的可执行文件只能在本机运行。但我们的目标是我们写的程序可以被更多人使用，下面分享下QT项目/QML项目如何发布！ 作者环境：Win7 + Qt5.9.0 Qt Creator直接编译生成的.exe文件是不可以直接点击运行的： 提示找不到库，原因是在Qt Creator调试运行时，已经帮我们设置好环境变量，让程序运行时可以正确找到对应的库文件。所以我们...
发布的QT程序无法显示图标和图片的问题
shiweiqiang365的专栏
04-11 1732
       在windows下编译好的QT程序在其他没有安装QT的机器上会出现图标和图片无法正常显示的问题。        这时我们可以通过以下方式来解决：        在release文件夹里创建plugins文件夹，并将QT安装目录下的plugins/imageformats文件夹复制到release/plugins文件夹（imageformats文件夹包含了许多图片格式的插件，如
QML动态Release后程序进程还在却无法显示（mingw版本）
懒虫不懒，不信你看！
04-26 766
qt-opensource-windows-x86-mingw530-5.7.1.exeWin10 32位平台使用Qt Quick Control 2.0 版本用windeployqt打包后，出现进程中存在，但无法显示的问题。经检查，在Qt目录里有两个Qt5Core.dll1、C:\Qt\Qt5.7.1\5.7\mingw53_32\bin2、C:\Qt\Qt5.7.1\Tools\QtCreat...
QT资源文件中的图片不能在release版本中显示出来
12-17 8208
最近做了一个QT点名签到的客户端程序 ，给应用程序和托盘添加了图标在本机调试时这些图标都可以正常显示，但是把程序移植到其他机器上的时候发现这些图标都不能显示出来了 ，结果在网上找了半天终于找到了解决的方法 可能不能正确显示图片。解决方法如下：要显示自己加入qrc文件中的信息，需要把qt的一个文件包复制，跟release.exe（即是你编译出来的可执行文件）放在一个文件夹中，这样在
Qt 使用了qml后打包发布应用遇到的问题
我不是码农的博客~~~
03-21 364
现象： 按照https://www.cnblogs.com/judes/p/11247728.html的方法，能生成一些exe所需环境和动态库，但是打开程序，用到了qml的地方，全是黑色的。 原因： Qt5.10这个版本【目前只有这个版本遇到这个问题】，通过windployqt的方法，关于qml相关的环境都没有加进去，在执行指令的时候就提示了QML相关的dll被禁用了【不懂为什么】，把同样的代码在Qt5.12就可正常运行 解决： 把D:\Soft\Qt5.10.1\5.10.1\mingw53_32\qm
QT开发使用QML后无法打开生成的exe的问题
金属服务，美好生活，天网改变世界，华帝量子科技。
09-03 654
原因是使用windeployqt会修改里面的DLL 解决办法：将Qt5Core.dll和Qt5Widgets.dll替换为QT安装目录里面的同名库 安装目录位置 替换掉后就可以正常运行了
ubuntu系统中qt程序生成的Release版本的可执行程序无法运行
02-28
<think>好的，我现在需要解决用户的问题：在Ubuntu系统中，使用Qt生成的Release版本可执行程序无法运行。用户可能已经完成了程序的开发，但在发布时遇到了问题。我需要分析可能的原因，并提供解决方案。 首先，我应该回想常见的Qt程序在Linux下发布的问题。常见的可能性包括依赖库缺失、文件路径问题、权限不足、构建配置错误等。我需要逐一分析这些可能性，并给出对应的解决方法。 第一步，依赖库的问题。Qt程序通常依赖于许多动态库，比如Qt自身的库（libQt5Core.so等）和其他第三方库。在开发环境中，这些库已经安装，所以Debug版本可以运行。但Release版本可能在目标机器上缺少这些库。用户可能没有正确部署这些依赖库，导致可执行文件无法找到它们。 解决方法建议用户使用ldd命令检查依赖，例如在终端运行ldd ./YourProgram，查看是否有未找到的库。如果有，需要将这些库复制到可执行文件的目录，或者设置LD_LIBRARY_PATH环境变量指向库的路径。另外，可以推荐使用linuxdeployqt工具自动打包依赖库。 第二步，文件路径问题。如果程序在运行时需要访问资源文件（如图标、配置文件等），在Release版本中路径可能不正确。开发时可能使用相对路径，但Release版本可能被移动到其他位置，导致资源找不到。需要检查程序中的文件路径是否正确，是否使用QCoreApplication::applicationDirPath()来获取可执行文件所在目录的绝对路径。 第三步，权限问题。用户可能没有给可执行文件添加执行权限。需要检查文件的权限，使用chmod +x YourProgram命令添加执行权限。 第四步，构建配置问题。可能Release版本的构建配置有误，例如没有正确链接某些库，或者编译器选项导致的问题。建议用户清理项目，重新构建Release版本，并确保Qt Creator中的构建配置正确，比如是否正确选择了Release模式，是否安装了对应的Qt Release库。 第五步，Qt平台插件问题。有时候缺少平台插件，比如无法找到xcb插件，导致图形界面无法启动。这种情况下，程序可能需要plugins目录中的平台插件。用户需要将Qt安装目录下的plugins/platforms复制到可执行文件目录中，并确保程序能找到它们。可以通过设置QT_DEBUG_PLUGINS=1来调试插件加载问题。 第六步，检查是否有崩溃或错误输出。建议用户尝试在终端中直接运行可执行程序，查看错误信息。例如，运行./YourProgram，终端可能会输出缺失的库或错误原因，如GLIBC版本不兼容等。根据具体错误信息进一步解决。 第七步，版本兼容性问题。可能目标系统的库版本与编译时使用的版本不一致，导致兼容性问题。如果使用较新的Qt版本编译，而目标系统较旧，可能需要静态编译或使用AppImage等打包方式解决。 总结以上步骤，用户需要逐步排查依赖库、路径、权限、构建配置、平台插件等问题。可能的解决步骤包括使用ldd检查依赖，复制必要的库，设置环境变量，检查文件权限，确保资源路径正确，以及打包必要的Qt插件。 最后，可能需要给出一个具体的例子，指导用户如何操作，例如如何使用linuxdeployqt工具自动打包所有依赖，或者如何设置LD_LIBRARY_PATH。同时提醒用户，如果问题仍然存在，需要根据终端的错误信息进一步分析。</think>在Ubuntu系统中，Qt生成的Release版本可执行文件无法运行通常由以下原因导致，可按以下步骤排查和解决： --- ### 一、依赖库缺失（最常见原因） #### 现象： 终端运行时报错 `error while loading shared libraries: xxx: cannot open shared object file` #### 解决方案： 1. **使用 `ldd` 检查依赖** 在终端执行： ```bash ldd ./YourProgram ``` 检查输出中是否有 `not found` 的库（如 `libQt5Core.so.5`）。 2. **手动部署依赖库** - 将缺失的库文件复制到可执行文件同级目录下的 `lib` 文件夹中 - 或设置环境变量： ```bash export LD_LIBRARY_PATH=/path/to/your/libs:$LD_LIBRARY_PATH ``` 3. **自动打包工具** 推荐使用 `linuxdeployqt` 自动收集依赖： ```bash linuxdeployqt ./YourProgram -appimage ``` --- ### 二、Qt插件缺失（如平台插件） #### 现象： 报错 `This application failed to start because it could not find or load the Qt platform plugin "xcb"` #### 解决方案： 1. 从Qt安装目录复制插件： ```bash cp -r /path/to/Qt/plugins/platforms /path/to/YourProgram/ ``` 2. 运行程序时指定插件路径： ```bash ./YourProgram -platform xcb --platforms-path ./platforms ``` --- ### 三、文件权限问题 #### 现象： 运行时报错 `Permission denied` #### 解决方案： 为可执行文件添加权限： ```bash chmod +x ./YourProgram ``` --- ### 四、路径问题（资源文件未找到） #### 现象： 程序启动后崩溃，或无法加载图片、配置文件等资源 #### 解决方案： 1. 在代码中使用绝对路径（推荐）： ```cpp QString path = QCoreApplication::applicationDirPath() + "/data/config.ini"; ``` 2. 将资源文件（如 `qml`、`images`）复制到可执行文件同级目录中。 --- ### 五、构建配置问题 #### 现象： Release版本未正确生成或优化导致异常 #### 解决方案： 1. 清理并重新构建项目： ```bash cd build rm -rf * qmake .. make -j4 ``` 2. 确保Qt Creator中选择了 `Release` 模式，并安装了对应的Qt库（如 `Qt 5.x Release`）。 --- ### 六、调试技巧 1. **在终端运行程序** 直接执行 `./YourProgram`，观察终端输出的具体错误信息。 2. **启用Qt插件调试** ```bash export QT_DEBUG_PLUGINS=1 ./YourProgram ``` 3. **检查GLIBC版本兼容性** 如果报错 `version 'GLIBC_2.34' not found`，说明编译环境版本过高，需在低版本系统中重新编译。 --- ### 七、终极方案：静态编译或打包 如果依赖问题复杂，可选择： 1. **静态编译** 在Qt配置时添加 `-static` 参数，但需注意Qt的许可协议（LGPL要求动态链接）。 2. **打包为AppImage** 使用 `linuxdeployqt` 生成独立运行的AppImage文件。 --- 通过以上步骤逐步排查，通常可以解决大部分Qt Release版本无法运行的问题。如果仍存在问题，建议提供终端报错信息以便进一步分析。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Fu_Lin_

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值