尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
Qt 打包 exe 避坑指南:windeployqt + NSIS 生成安装包
本文介绍如何将 Qt 开发的应用程序打包成专业的 Windows 安装包.exe使用 windeployqt 收集依赖再通过 NSIS 制作安装程序。一、准备工作二、第一步生成 Release 版 exe必须使用 Release 模式编译Debug 版本依赖调试库体积大且无法独立运行。1在 Qt Creator 中打开项目2将构建模式切换为 Release3编译项目4找到生成的 .exe 文件一般位于text 项目根目录/build-项目名-Desktop_Qt_版本号_编译器-bit-Release/release/三、第二步收集 Qt 依赖库Qt 程序依赖大量动态链接库DLL需要使用 windeployqt 工具自动收集。3.1 创建独立文件夹新建一个文件夹如 package将上一步生成的 .exe 复制进去。3.2 运行 windeployqt打开 Qt 自带的命令行工具不要用 Windows 自带的 cmdcd 到 package 目录执行bash windeployqt.exe--release YourApp.exe3.3 检查依赖windeployqt 会自动复制所有必需的 Qt 库、插件如 platforms/qwindows.dll、QML 文件等到 exe 所在目录。注意如果程序使用了 Qt 的图片格式插件如 jpg、gif需要额外检查 imageformats 文件夹是否被正确拷贝。四、第三步使用 NSIS 制作安装包4.1 编写 NSIS 脚本创建一个 .nsi 脚本文件这是 NSIS 的配置文件用于定义安装包的行为。以下是一个完整的脚本模板;启用 Unicode 支持避免中文乱码 Unicode true;引入现代界面库!includeMUI2.nsh;基础信息 NameYourAppNameOutFileYourApp-Setup-v1.0.0.exeInstallDir$PROGRAMFILES64\YourAppNameRequestExecutionLevel admin;压缩方式 SetCompressor/SOLID lzma;界面页面配置!insertmacro MUI_PAGE_WELCOME!insertmacro MUI_PAGE_DIRECTORY!insertmacro MUI_PAGE_INSTFILES!insertmacro MUI_PAGE_FINISH;卸载页面!insertmacro MUI_UNPAGE_WELCOME!insertmacro MUI_UNPAGE_CONFIRM!insertmacro MUI_UNPAGE_INSTFILES;语言简体中文英文可选!insertmacro MUI_LANGUAGESimplifiedChinese!insertmacro MUI_LANGUAGEEnglish;安装主逻辑 SectionInstall;设置安装目录 SetOutPath$INSTDIR;复制所有文件已用 windeployqt 收集好依赖 File/rpackage\*.*;创建桌面快捷方式 CreateShortcut$DESKTOP\YourAppName.lnk$INSTDIR\YourApp.exe;创建开始菜单快捷方式 CreateDirectory$SMPROGRAMS\YourAppNameCreateShortcut$SMPROGRAMS\YourAppName\YourAppName.lnk$INSTDIR\YourApp.exeCreateShortcut$SMPROGRAMS\YourAppName\卸载.lnk$INSTDIR\Uninstall.exe;写入卸载程序 WriteUninstaller$INSTDIR\Uninstall.exe;写入注册表用于控制面板显示 WriteRegStr HKLMSoftware\Microsoft\Windows\CurrentVersion\Uninstall\YourAppName\DisplayNameYourAppNameWriteRegStr HKLMSoftware\Microsoft\Windows\CurrentVersion\Uninstall\YourAppName\UninstallString$INSTDIR\Uninstall.exeSectionEnd;卸载逻辑 SectionUninstallDelete$INSTDIR\*.*RMDir/r$INSTDIRDelete$DESKTOP\YourAppName.lnkRMDir/r$SMPROGRAMS\YourAppNameDeleteRegKey HKLMSoftware\Microsoft\Windows\CurrentVersion\Uninstall\YourAppNameSectionEnd4.2 脚本关键配置说明4.3 编译生成安装包两种方式命令行在 NSIS 安装目录下运行bash makensis.exe YourApp.nsi2图形界面右键点击 .nsi 文件 → “Compile NSIS Script”或拖入 NSIS 窗口编译。编译成功后会在脚本同级目录生成 YourApp-Setup-v1.0.0.exe 安装包。五、常见问题与解决六、总结完整流程概览编写 Qt 程序 ↓ Release 模式编译生成.exe ↓ windeployqt 收集依赖库 ↓ 编写 NSIS 脚本.nsi ↓ makensis 编译生成安装包 ↓ 测试安装包 → 发布按照以上步骤你可以将 Qt 应用程序打包成专业的 Windows 安装包方便分发给用户使用。
RELATED

相关推荐

AI前沿日报 2026-09-05

AI前沿日报 2026-09-05

GPT-6 Astra 全面推送首日:安全边界与性能飞跃的交织一、今日头条:GPT-6 Astra 全球推送日2026年9月5日,OpenAI 正式向全体 Plus 用户推送 GPT-6 Astra 模型,标志着大模型能力边界的又一次重大突破。然而,性能飞跃的同…

📅 2026/9/13 8:14:35
Cesium WebGL Shader编程:地图扫描与飞线动画性能优化实战

Cesium WebGL Shader编程:地图扫描与飞线动画性能优化实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📅 2026/11/11 22:26:08
工业AI技术指南:从数据采集到模型部署的完整实战方案

工业AI技术指南:从数据采集到模型部署的完整实战方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📅 2026/10/28 7:38:17
MORE NEWS

更多资讯

📰

支护工特种作业证千万别踩坑!外省证怎么转过来?一文讲清

支护工特种作业证千万别踩坑!外省证怎么转过来?一文讲清 之前考的证在外省能不能转过来?这是很多支护工最关心的问题,特别是像漯河这样的水利工程从业者,经常需要跨省工作,证书能不能跟着走,直接影响到你能不能正常上岗。如果你之前在外地考的支护工特…

📰

电工证的样本图片高清怎么考?官方报名入口在哪?

电工证的样本图片高清怎么考?官方报名入口在哪? 怕考不过白交培训费?这年头,特种作业证成了很多工种的“门槛证”,尤其是电工证,更是不少建筑、电力行业的从业者必须考下的“硬通货”。但很多人心里都有个疙瘩—— 电工证的样本图片高清…

📰

盛泽办电工证多少钱?怕考不过白交培训费?看完这篇再报名

盛泽办电工证多少钱?怕考不过白交培训费?看完这篇再报名 你是不是也遇到过这样的情况:报名了盛泽办电工证,花了大几千,结果考试一塌糊涂,白忙活一场?别急,今天就来聊聊这个事,让你花得值,考得过。…

📰

工地太忙根本没时间复习考试?盛泽办电工证上岗必备全攻略

工地太忙根本没时间复习考试?盛泽办电工证上岗必备全攻略 工地太忙根本没时间复习考试,这几乎是每个特种作业人员的真实写照。尤其是电工证,作为 上岗必备…

📰

商南县高压电工证通过率揭秘:外省证书能转吗?手把手教你解决

商南县高压电工证通过率揭秘:外省证书能转吗?手把手教你解决 之前考的证在外省能不能转过来?这个问题,我听得太多了,不管是刚入行的新人,还是打算转行的同行,几乎每个人都会问。商南县高压电工证的通过率到底怎么样?有没有什么隐藏门槛?今天我就以多…

📰

用高压电工证的在哪考?急需特种作业证才能上岗找工作

用高压电工证的在哪考?急需特种作业证才能上岗找工作 你是不是正被“急需特种作业证才能上岗找工作”这个问题搞得焦头烂额?特别是 用高压电工证的 人群,面对高压电工证的考试门槛,不知道从哪儿下手,更不知道 在哪考…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬