如何打包qt项目为.exe

引言

详细介绍在 MinGW 编译器环境下,将 Qt 程序打包为可独立运行的 .exe 可执行文件的完整步骤,适用于 Qt 开发新手快速掌握打包流程。

Qt 程序打包为 .exe 文件(MinGW 编译器)

以下为 MinGW 编译器下 Qt 程序打包的核心操作步骤,全程以清晰的操作指引 + 关键注意点呈现:

第一步:创建 Qt 工程并完成基础开发
  1. 打开 Qt Creator,创建符合需求的 Qt 工程(如 Widgets 应用、控制台程序等);
  2. 完成代码编写与调试,确保程序在 Qt Creator 中能正常运行。
第二步:以 Release 模式编译程序并定位目标 .exe 文件
  1. 在 Qt Creator 界面左上角的「构建模式」下拉菜单中,选择 Release 模式(默认可能为 Debug,Debug 模式生成的文件体积大且依赖调试库,不适合打包);
  2. 点击「运行」按钮(或快捷键 Ctrl+R),完成 Release 模式下的编译;
  3. 编译完成后,右键点击 Qt Creator 左侧的工程名称,选择「在文件管理器中显示」,打开工程对应的文件目录;
  4. 在工程目录中找到 release 文件夹(Release 模式编译产物的存放目录),进入后可看到生成的 .exe 可执行文件;
  5. 复制该 .exe 文件的完整文件路径(建议路径中不含中文、空格等特殊字符,避免后续命令执行出错)。

找到对应的release模式下编译的文件

在里面找到release文件夹

第三步:通过 MinGW 命令行执行打包命令
  1. 打开 Qt 配套的 MinGW 编译器命令窗口(可在 Qt 安装目录的 Tools/MinGW/[版本号]/bin 下找到 mingw64.exe,或通过开始菜单的「Qt 版本号 (MinGW 位数)」快捷方式打开);
  1. 在命令窗口中,使用 cd 命令跳转到第二步复制的 .exe 文件所在路径(示例:cd D:\QtProject\MyApp\release);
  1. 输入打包命令:windeployqt 你的程序名称.exe(示例:windeployqt MyApp.exe),回车执行;
  1. 命令执行完成后,release 文件夹中会自动生成程序运行所需的所有依赖库(如 Qt 核心库、MinGW 运行库等),此时该 .exe 文件即可脱离 Qt Creator 环境独立运行。

总结

  1. 打包前需确保程序以 Release 模式 编译,避免使用 Debug 模式(依赖多、体积大);
  2. 执行 windeployqt 命令前,需将命令行路径切换至 .exe 文件所在目录,且路径不能包含中文 / 空格;
  3. windeployqt 命令的核心作用是自动拷贝程序运行所需的所有依赖库,使 .exe 可独立运行。
相关推荐
覆东流1 小时前
7.Java数组
java·开发语言·后端
码行山野赴时序归途1 小时前
三道经典数组题:从暴力到最优的算法思维
c语言·开发语言·数据结构·算法·leetcode
lzhdim2 小时前
提高 SQL 语句执行速度的方法
java·开发语言·数据库·sql·oracle
JavaPub-rodert2 小时前
王仕宇在 Go Context 如何解决协程泄漏与超时控制
开发语言·后端·golang·iphone·javapub·王仕宇
ly76893 小时前
JavaScript 从入门到进阶:核心语法、异步编程与工程化实践
开发语言·javascript·ecmascript
落魄大学生之流水线上谋生计4 小时前
Java锁全面指南:从基础概念到企业级应用
java·开发语言
for_ever_love__4 小时前
python基础语法学习: 闭包
开发语言·python·学习·闭包
ly76894 小时前
Python 全面入门:从核心语法到工程实践
开发语言·python
艾伦_耶格宇5 小时前
【AI】-4 OpenCode Go 接入 Obsidian 完整指南
运维·开发语言·人工智能·agent·opencode
旋生万物5 小时前
【终极实战】用Python从零“生成“一个宇宙:螺旋干涉模型的代码实现
开发语言·前端·人工智能·react.js·php·wpf