这是 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.dllDLL 位置:
- 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使用方法:
- 修改
QT_PATH为你的 Qt 安装路径 - 修改
BUILD_PATH为你的编译输出路径 - 每次编译后双击运行,自动生成可分发的文件夹
方案三:制作安装程序(最专业)
使用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 编译后自动完成依赖部署。