news 2026/5/22 2:36:24

QT打包Release后,点击exe文件报错dll缺失

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
QT打包Release后,点击exe文件报错dll缺失

这是 Qt 程序发布的常见问题。你的电脑有 Qt 环境,DLL 在系统路径中;同事电脑没有,所以找不到。

解决方案:使用 windeployqt 打包

方法一:命令行打包(推荐)

步骤1:打开 Qt 命令行工具

从开始菜单找到并打开:

Qt 5.x.x → Qt 5.x.x (MinGW/MSVC) → Qt 5.x.x Command Prompt

步骤2:进入 exe 所在目录

cd /d D:\你的项目\build\release

步骤3:运行 windeployqt

windeployqt MavlinkAnalyzer.exe ``` **步骤4:检查结果** 工具会自动复制所需的 DLL 到 exe 同目录,包括: - Qt5Core.dll - Qt5Gui.dll - Qt5Widgets.dll - Qt5SerialPort.dll - platforms/qwindows.dll - 等等... **步骤5:打包发送** 将整个文件夹压缩发给同事即可。 --- ### 方法二:手动操作(如果方法一不行) **必需的 DLL 文件:** ``` MavlinkAnalyzer.exe │ ├── Qt5Core.dll ├── Qt5Gui.dll ├── Qt5Widgets.dll ├── Qt5SerialPort.dll │ ├── platforms/ │ └── qwindows.dll │ ├── styles/ │ └── qwindowsvistastyle.dll │ └── (如果用MinGW编译) ├── libgcc_s_seh-1.dll ├── libstdc++-6.dll └── libwinpthread-1.dll

DLL 位置:

  • Qt DLL:C:\Qt\5.x.x\mingw_64\bin\msvc2019_64\bin\
  • platforms:C:\Qt\5.x.x\mingw_64\plugins\platforms\

完整打包脚本

创建deploy.bat,放在 exe 同目录:

@echo off echo 正在打包... :: 设置Qt路径(根据你的安装修改) set QT_PATH=C:\Qt\5.15.2\mingw81_64 :: 运行windeployqt %QT_PATH%\bin\windeployqt.exe --release MavlinkAnalyzer.exe :: 如果是MinGW编译,复制编译器运行时 copy "%QT_PATH%\bin\libgcc_s_seh-1.dll" . copy "%QT_PATH%\bin\libstdc++-6.dll" . copy "%QT_PATH%\bin\libwinpthread-1.dll" . echo 打包完成! pause ``` --- ### 打包后的目录结构 ``` MavlinkAnalyzer/ ├── MavlinkAnalyzer.exe ├── Qt5Core.dll ├── Qt5Gui.dll ├── Qt5Widgets.dll ├── Qt5SerialPort.dll ├── libgcc_s_seh-1.dll (MinGW) ├── libstdc++-6.dll (MinGW) ├── libwinpthread-1.dll (MinGW) ├── platforms/ │ └── qwindows.dll └── styles/ └── qwindowsvistastyle.dll

把这个文件夹压缩成 zip 就可以了。


一劳永逸的办法

方案一:静态编译(单个 exe,无依赖)

最彻底的方法,生成一个独立的 exe 文件,不需要任何 DLL。

缺点:需要重新编译 Qt 静态库,比较耗时(约1-2小时)。


方案二:一键打包脚本(推荐,简单实用)

在项目中创建deploy.bat,每次编译后双击运行即可:

@echo off chcp 65001 >nul echo ======================================== echo MAVLink Analyzer 一键打包工具 echo ======================================== :: ========== 配置区(只需修改一次)========== set APP_NAME=MavlinkAnalyzer set QT_PATH=C:\Qt\5.15.2\mingw81_64 set BUILD_PATH=%~dp0build\release set OUTPUT_PATH=%~dp0dist\%APP_NAME% :: ========================================== echo. echo [1/4] 清理旧文件... if exist "%OUTPUT_PATH%" rd /s /q "%OUTPUT_PATH%" mkdir "%OUTPUT_PATH%" echo [2/4] 复制主程序... copy "%BUILD_PATH%\%APP_NAME%.exe" "%OUTPUT_PATH%\" echo [3/4] 部署Qt依赖... %QT_PATH%\bin\windeployqt.exe --release --no-translations --no-opengl-sw "%OUTPUT_PATH%\%APP_NAME%.exe" echo [4/4] 复制编译器运行时... copy "%QT_PATH%\bin\libgcc_s_seh-1.dll" "%OUTPUT_PATH%\" 2>nul copy "%QT_PATH%\bin\libstdc++-6.dll" "%OUTPUT_PATH%\" 2>nul copy "%QT_PATH%\bin\libwinpthread-1.dll" "%OUTPUT_PATH%\" 2>nul echo. echo ======================================== echo 打包完成! echo 输出目录: %OUTPUT_PATH% echo ======================================== echo. :: 打开输出目录 explorer "%OUTPUT_PATH%" pause

使用方法

  1. 修改QT_PATH为你的 Qt 安装路径
  2. 修改BUILD_PATH为你的编译输出路径
  3. 每次编译后双击运行,自动生成可分发的文件夹

方案三:制作安装程序(最专业)

使用Inno Setup(免费)制作 exe 安装包。

步骤1:下载安装 Inno Setup

步骤2:创建installer.iss脚本:

#define MyAppName "MAVLink Analyzer" #define MyAppVersion "1.0" #define MyAppPublisher "ACFly" #define MyAppExeName "MavlinkAnalyzer.exe" [Setup] AppId={{YOUR-GUID-HERE} AppName={#MyAppName} AppVersion={#MyAppVersion} AppPublisher={#MyAppPublisher} DefaultDirName={autopf}\{#MyAppName} DefaultGroupName={#MyAppName} OutputBaseFilename=MavlinkAnalyzer_Setup_v{#MyAppVersion} Compression=lzma2 SolidCompression=yes [Files] Source: "dist\MavlinkAnalyzer\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs [Icons] Name: "{group}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}" Name: "{commondesktop}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}" [Run] Filename: "{app}\{#MyAppExeName}"; Description: "启动程序"; Flags: nowait postinstall skipifsilent

步骤3:用 Inno Setup 编译,生成单个安装程序

最终效果

  • 生成一个MavlinkAnalyzer_Setup_v1.0.exe
  • 双击安装,自动创建桌面快捷方式
  • 支持卸载

方案四:集成到 Qt Creator(全自动)

.pro文件添加自动部署:

# 自动部署配置 CONFIG(release, debug|release) { DESTDIR = $$PWD/dist/release # Windows自动部署 win32 { DEPLOY_TARGET = $$shell_path($$DESTDIR/$$TARGET.exe) QMAKE_POST_LINK += $$[QT_INSTALL_BINS]/windeployqt --release --no-translations $$DEPLOY_TARGET } }

这样每次 Release 编译后自动完成依赖部署。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/20 19:08:10

阅读APP书源配置终极指南:免费获取海量小说资源

阅读APP书源配置终极指南:免费获取海量小说资源 【免费下载链接】Yuedu 📚「阅读」APP 精品书源(网络小说) 项目地址: https://gitcode.com/gh_mirrors/yu/Yuedu 想要在阅读APP中畅享海量小说资源?书源配置是关…

作者头像 李华
网站建设 2026/5/22 1:41:06

OCLP-Mod魔法解密:3步让老旧Mac完美运行最新macOS系统

OCLP-Mod魔法解密:3步让老旧Mac完美运行最新macOS系统 【免费下载链接】OCLP-Mod A mod version for OCLP,with more interesting features. 项目地址: https://gitcode.com/gh_mirrors/oc/OCLP-Mod 还记得那个陪伴你多年的Mac吗?它曾经流畅运行&…

作者头像 李华
网站建设 2026/5/21 8:24:20

Docker+Agent服务版本混乱的真相(90%团队都忽略的关键细节)

第一章:DockerAgent服务版本混乱的真相在微服务架构广泛落地的今天,Docker 与各类 Agent(如监控、日志采集、APM 等)的组合部署已成为标准实践。然而,许多团队在实际运维中频繁遭遇“版本不一致”引发的兼容性问题&…

作者头像 李华
网站建设 2026/5/20 18:11:37

VSCode重磅更新:内置量子模拟器扩展,开发者必须立即掌握的3项技能

第一章:量子模拟器扩展的 VSCode 更新Visual Studio Code 最新更新引入了对量子计算开发的强大支持,通过集成量子模拟器扩展,开发者能够在本地环境中高效编写、调试和运行量子算法。这一更新显著降低了量子编程的入门门槛,使经典程…

作者头像 李华