news 2026/6/10 5:33:11

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/6/9 15:45:47

MCreator终极指南:零代码制作专业级Minecraft模组

MCreator终极指南:零代码制作专业级Minecraft模组 【免费下载链接】MCreator MCreator is software used to make Minecraft Java Edition mods, Bedrock Edition Add-Ons, and data packs using visual graphical programming or integrated IDE. It is used world…

作者头像 李华
网站建设 2026/6/9 16:10:35

MCP AI-102量子模型评估实战指南(90%工程师忽略的精度陷阱)

第一章:MCP AI-102量子模型评估的核心意义在当前人工智能与量子计算融合发展的前沿领域,MCP AI-102量子模型的评估不仅是技术验证的关键环节,更是推动算法优化与实际应用落地的重要支撑。该模型结合了混合量子-经典神经网络架构,在…

作者头像 李华
网站建设 2026/6/9 5:48:48

Vue3+Element Plus后台管理系统实战指南:从入门到精通

Vue3Element Plus后台管理系统实战指南:从入门到精通 【免费下载链接】vue-element-plus-admin A backend management system based on vue3, typescript, element-plus, and vite 项目地址: https://gitcode.com/gh_mirrors/vu/vue-element-plus-admin 还在…

作者头像 李华
网站建设 2026/6/9 16:14:09

量子电路仿真调试难题破解:3步完成交互式可视化集成

第一章:量子电路可视化的交互操作在现代量子计算开发中,量子电路的可视化不仅是理解量子算法结构的关键,更是调试与优化的重要手段。通过图形化界面或编程接口,开发者能够直观地构建、修改和分析量子线路,从而提升开发…

作者头像 李华
网站建设 2026/6/7 8:24:01

dc.js隐私保护可视化:构建合规的数据展示系统

dc.js隐私保护可视化:构建合规的数据展示系统 【免费下载链接】dc.js Multi-Dimensional charting built to work natively with crossfilter rendered with d3.js 项目地址: https://gitcode.com/gh_mirrors/dc/dc.js 在数据驱动决策成为企业标配的今天&…

作者头像 李华
网站建设 2026/6/8 13:44:17

30分钟精通ComfyUI智能字幕插件的完整部署手册

30分钟精通ComfyUI智能字幕插件的完整部署手册 【免费下载链接】ComfyUI_SLK_joy_caption_two ComfyUI Node 项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI_SLK_joy_caption_two 在AI绘画创作中,智能字幕生成是提升工作效率的关键环节。本文将为您详…

作者头像 李华