第一次把桌面程序发给别人,几乎都会经历这一幕:自己机器上双击就开,同事机器上双击弹一个「无法启动此程序,因为计算机中丢失 libstdc++-6.dll」,或者更含糊的「应用程序无法正常启动 (0xc000007b)」。你打开自己的目录看,exe 明明就在那里,大小也对,怎么就少东西了?

因为 exe 从来不是全部。它依赖的 C++ 运行库、系统 DLL、Qt 库、插件、资源文件,构成了一个运行环境。开发机上这个环境是装编译器时顺手铺好的,目标机上没有。这篇就把「怎么让它在别人机器上跑起来」这件事拆开:先看依赖,再选链接方式,最后做安装包。

这篇的实测环境有两套编译器。前面讲导入表和静态链接的部分,用的是本机 MinGW g++ 16.2,体积数字都是 objdump 和文件属性直接读出来的;后面 Qt 部署的部分,用的是同一台机器上的 Qt 6.8.3(win64_msvc2022_64,只装了 qtbase 一个归档)加 MSVC 19.51 和 CMake 4.4.4。windeployqt 真跑过一遍,复制了多少文件、占了多大体积、每个 DLL 多大,下面逐条列出。只有静态 Qt 链接这一项没条件验证——本机装的是共享版 Qt,没有静态库可链,文中会单独标出来。

先搞清楚 exe 依赖了什么

Windows 的 exe 是 PE 格式,文件头里有一张导入表,列出它启动时需要哪些 DLL、用到哪些函数。查看导入表有两个常用工具:MSVC 的 dumpbin /dependents,MinGW 的 objdump -p。先看一个用了 std::filesystem 和文件流的程序:

g++ -std=c++20 paths.cpp -o paths.exe
objdump -p paths.exe | findstr "DLL Name"

本机实际输出:

DLL Name: libgcc_s_seh-1.dll
DLL Name: KERNEL32.dll
DLL Name: msvcrt.dll
DLL Name: libstdc++-6.dll

四行里,KERNEL32.dll 和 msvcrt.dll 是 Windows 自带的,任何机器都有;libgcc_s_seh-1.dll 和 libstdc++-6.dll 是 MinGW 编译器带进来的,目标机通常没有。所以「开发机能跑、客户机缺 DLL」不是玄学,导入表里写得清清楚楚。

用 MSVC 编译时,对应的是 VCRUNTIME140.dll、MSVCP140.dll 这些。目标机如果没装 VC++ 运行库,同样报缺 DLL。两种编译器解决这个问题的思路一样:要么把运行库随包发,要么静态链接进 exe。

动态链接与静态链接:用数字说话

同一个源文件,加不加 -static,产物差别很大。先看动态链接:

g++ -std=c++20 paths.cpp -o paths-dynamic.exe

本机实测:文件 144KB,导入 libgcc_s_seh-1.dll 和 libstdc++-6.dll。程序本身很小,但运行依赖外部 DLL。

再看完整静态链接:

g++ -std=c++20 -static paths.cpp -o paths-static.exe

本机实测:文件 2883KB(约 2.8MB),导入表只剩 KERNEL32.dll 和 msvcrt.dll,两个 MinGW 运行库都不再需要。代价是体积涨了约 20 倍。

还有一个中间选项,只静态链接 GCC 和标准库,不静态链接 pthread:

g++ -std=c++20 -static-libgcc -static-libstdc++ paths.cpp -o paths-partial.exe

本机实测:2828.7KB,导入表里仍然有 libwinpthread-1.dll。也就是说,少了一个 DLL 不等于全解决,漏掉的那个照样会让程序起不来。要么用完整 -static,要么把剩下的 DLL 一起发。

静态链接还能再瘦身。加 -s 去掉符号表:

g++ -std=c++20 -static -s paths.cpp -o paths-static-strip.exe

本机实测从 2883KB 降到 1171.5KB(约 1.1MB),体积几乎砍半。符号表对发布版没用,对排查崩溃有用;如果以后要做崩溃分析,得另外保留一份带符号的构建和 PDB,别把唯一的符号丢了。

构建方式体积(本机实测)还需要哪些非系统 DLL
默认动态链接144KBlibgcc_s_seh-1.dll、libstdc++-6.dll
只静态 libgcc/libstdc++2828.7KBlibwinpthread-1.dll
完整静态链接2883KB无
完整静态 + 去符号1171.5KB无
静态链接不是越小越好,也不是越大越好。它的价值是「少一个部署失败点」,适合内部小工具、单文件分发、不能确定目标机装了什么的场景。库要频繁安全更新、多个程序共享同一份运行库时,动态链接更合理。

Qt 程序怎么部署

Qt 比自己写 Win32 多一层:除了 C++ 运行库,还要带 Qt 自己的库和插件。手动一个个拷 DLL 很容易漏,官方给了 windeployqt 工具,它会扫描 exe 的导入表,把用到的 Qt 库、平台插件、图片格式插件复制到指定目录。本机实际执行的命令是:

windeployqt --release --no-translations .\build\Release\qtlab.exe

它没有输出「成功」两个字,只在控制台逐条打印被处理的模块。本机这次的最终目录一共 15 个文件,合计 29.3 MB,其中 exe 本身只有 56.0 KB——打包后体积的 99% 以上都是 Qt 库和插件。

按文件看更直观:Qt6Gui.dll 9068 KB、Qt6Widgets.dll 6348 KB、Qt6Core.dll 6015 KB、D3Dcompiler_47.dll 4560 KB、Qt6Network.dll 1714 KB、platforms\qwindows.dll 886.6 KB,这六个就占了绝大部分;剩下的几个文件是图片格式插件、样式插件和图形相关的运行库,我没有逐个核对名字。看到这里就能理解,为什么「一个空窗口 30 MB」不是 Qt 臃肿,而是它把跨平台的图形、字体、图像解码能力都做进了库里;--no-translations 只是省掉翻译文件,对总量影响很小。

部署目录能跑起来之后,下一步是把它交给安装脚本。本机验证过 CMake 的安装规则:cmake --install build --config Release --prefix stage 执行完,stage\bin\qtlab.exe 确实出现了,路径和 install(TARGETS qtlab RUNTIME DESTINATION bin) 写的一致。也就是说,构建、部署、安装这三步可以接成一条线:cmake --build 出 exe,windeployqt 补 DLL,cmake --install 按规则摆目录。

--no-translations 只是去掉翻译文件,界面语言仍由代码里的字符串决定;如果程序要跟随系统语言,翻译文件得留着。--dry-run 可以先看它会复制什么,不实际写文件,适合在 CI 里做检查。还有一个容易忽略的点:windeployqt 应该处理你要发布的那个 exe,而不是构建目录里带调试信息的版本。Debug 版 exe 会引用 Qt6Cored.dll 这类带 d 后缀的调试库,用 --release 部署 Debug exe 会漏掉它们。

这组数字还有一个现实含义:Qt 程序的升级包不能按 exe 大小来估。exe 只有 56.0 KB,部署目录却有 29.3 MB,Qt 库占了绝大部分。只替换 exe 的「热更新」在用户侧几乎无感,但一旦要换 Qt 版本,DLL 就得整批替换,二十多兆的增量在弱网环境里并不算小。静态链接会把体积压回一个文件,代价是每次升级都全量替换。所以动态还是静态,除了「少一个部署失败点」,也要把长期更新成本算进去。

目录结构本身也是一条检查线索。部署后的布局是 exe 在根目录,platforms\、styles\、imageformats\ 各占一个子目录,DLL 与 exe 同级。这个相对关系不能改:Qt 按 exe 所在目录去找插件,把 platforms 挪进子目录或改名,程序就找不到平台插件。安装脚本打包时要保留整棵目录树,不能只挑几个 DLL 复制。

部署完最可靠的验证方式是找一台没装 Qt 的干净机器(或新建虚拟机),把整个发布目录拷过去运行。本机只验证到「部署目录能启动、安装规则能落位」这一步,没有第二台干净机器,所以干净机上的效果仍是推断:按 Qt 的加载逻辑,platforms\qwindows.dll 是启动硬依赖,缺了会直接报平台插件初始化失败。同样不要只在自己开发机上验证:开发机的 PATH 里有 Qt 的 bin,缺文件也能跑,这会产生虚假的安全感。

安装包、绿色版与 MSIX

东西凑齐了,还要决定怎么交给用户。三种常见形态,代价各不相同:

绿色版(目录压缩包)

打包成 zip,用户解压就能用。优点是简单、可携带、不写注册表;缺点是没有卸载入口、不会创建快捷方式、多用户共用时配置容易混。适合内部工具、U 盘分发、演示版本。

安装包(Inno Setup / WiX)

生成 .exe 或 .msi,负责安装目录、快捷方式、卸载项、文件关联。Inno Setup 脚本简单,WiX 更贴近 Windows Installer 规范但学习成本高。适合正式对外发布。

MSIX 是微软较新的打包格式,支持干净卸载、容器化文件系统、自动更新,但要求签名证书,对某些系统集成(驱动、服务、Shell 扩展)限制较多。做传统桌面工具,Inno Setup 仍然是最省事的选择;要做商店分发或企业集中部署,再考虑 MSIX。

安装包要提前想清楚几件事:装到哪个目录(默认 Program Files,但允许用户改)、是否为所有用户安装(需要管理员权限)、卸载时保留还是删除用户配置、升级时怎么处理旧版本。这些决定写在脚本里,后期改起来很麻烦。

签名、杀毒与 SmartScreen

没有签名的 exe,从网上下载后运行时,Windows 会弹「已保护你的电脑」,用户得点「更多信息」再点「仍要运行」。这不是程序有问题,而是 SmartScreen 对未知发布者的默认拦截。给 exe 和安装包做代码签名(Authenticode)能显著减少这类提示,但签名证书要花钱,还要保管好私钥。

签名不是万能的。新证书没有信誉积累,前几次下载仍可能被拦;证书泄露或私钥保管不当,反而会连累所有已签名的版本。内部工具可以不做签名,通过内网分发、在文档里写清楚「点更多信息」;对外发布的产品,签名是基本成本。

杀毒误报是另一件麻烦事。静态链接、UPX 压缩、自解压安装包,都会提高误报概率,因为恶意软件也常用这些手法。体积优化到极致、再加壳压缩,可能换来「下载即被删」。遇到误报,正确做法是向厂商提交样本申诉,而不是让用户关杀毒。

体积还能怎么压

第一,去掉调试符号。-s 的效果上面已经看到,从 2.8MB 降到 1.1MB。MSVC 对应的是发布构建不生成 PDB、链接器加 /DEBUG:NONE(调试信息另存)。

第二,按需链接。只用到 QtCore 就别链 QtWidgets;只用到标准库的容器,就别引入整个重型库。静态链接的粒度是目标文件,链接器会丢掉没引用的函数,但前提是你没有把整个库都拖进来。

第三,优化级别。MinGW 用 -Os 优先体积,-O2 优先速度;两者在桌面工具上的差异通常是几十 KB到几百 KB,先用 -Os 试,卡顿再换 -O2。不要为了省几百 KB 把性能敏感的部分拖慢。

第四,谨慎用 UPX 之类的可执行压缩。它能显著减小文件,但会改变 PE 结构,增加杀毒误报,还可能影响启动速度。内部工具、确定不会触发拦截的场景可以用;对外分发的产品,不建议。

体积优化要有基线。先记录「当前版本、动态链接、未压缩」的体积和启动时间,再逐项改,每次只改一个变量。否则最后不知道是哪项改动带来的收益,也不知道是否引入了回归。

出问题时先看哪里

现象真实原因第一步查什么
提示缺 libstdc++-6.dll / libgcc_s_seh-1.dllMinGW 动态运行库没随包发布用 objdump -p 看导入表,决定静态链接还是把 DLL 一起发
提示缺 VCRUNTIME140.dll目标机没装 VC++ 运行库改用 /MT 静态链接运行库,或在安装包里附带运行库安装程序
启动报 0xc000007b32 位和 64 位组件混用,或依赖的 DLL 架构不匹配确认 exe、Qt 库、第三方 DLL 的位数全部一致
Qt 报找不到 windows 平台插件platforms\qwindows.dll 没部署,或插件路径被改检查发布目录结构,确认 platforms 与 exe 同级
开发机能跑,干净机器双击没反应开发机的 PATH 里有 Qt 或编译器目录,掩盖了缺失依赖在虚拟机或另一台机器上测,别在本机测
安装后快捷方式打不开快捷方式指向了构建目录,或「起始位置」为空导致相对路径失效检查安装脚本里的目标路径,以及程序是否依赖工作目录
升级后用户配置全丢安装包覆盖了用户数据目录,或卸载时删除了配置确认安装脚本只覆盖程序目录,用户数据单独保留
覆盖安装提示文件被占用旧版本进程还在运行,或更新器没有先退出程序安装前检测并结束旧进程,或提示用户先关闭

边界与代价

静态链接的代价不只是体积。运行库的安全更新不再自动生效,每个程序都带一份旧版本;多个程序各带一份,内存和磁盘都重复。动态链接把这些成本交给系统统一管理,但要求部署时把依赖带全。没有绝对正确的选择,只有和分发场景匹配的选择。

安装包的代价是维护。脚本、图标、许可协议、卸载逻辑、升级策略,都要跟着版本走。Inno Setup 脚本写起来不难,难的是把「升级时保留用户数据」「卸载时清理干净」「安装失败能回滚」这些边界处理好。下一篇会专门讲升级与崩溃排查。

签名的代价是钱和流程。证书有有效期,到期要换;私钥要放在受控环境,最好用硬件令牌或云签名服务;签名要在构建流水线里自动完成,不能靠人工记得。没有这套流程,签名反而会成为发布瓶颈。

体积优化的代价是可维护性。为了省几百 KB 引入特殊编译参数、裁剪模块、加壳,后续排查问题会更难,新人接手也要重新理解构建配置。内部工具优先保证「装得上、跑得稳」,体积排最后。

小结

发布前先看导入表:哪些 DLL 是系统自带,哪些是编译器或 Qt 带进来的。能确定目标机环境,就动态链接加随包依赖;不能确定,就静态链接换确定性。Qt 程序一定要用 windeployqt 补齐插件,并在干净机器上验证。最后再决定绿色版还是安装包,别把这三件事混在一起做。

把这套流程在本机走一遍,顺序是清楚的:MinGW 的裸程序用 objdump -p 看依赖,静态链接后从 2883 KB 去掉符号压到 1171.5 KB;Qt 程序用 CMake 构建出 56.0 KB 的 exe,windeployqt 补成 15 个文件、29.3 MB 的目录,cmake --install 按规则落到 stage\bin。每一步都能用文件大小和目录清单核对,不依赖「应该能跑」的直觉。

当天可以自己验证的练习:

  1. 用 objdump -p 查看手头任意一个 exe 的导入表,标出哪些 DLL 是系统自带的。
  2. 把同一个程序分别用默认、-static-libgcc -static-libstdc++、-static、-static -s 构建,记录体积和导入表变化。
  3. 把静态构建的 exe 拷到另一台没装 MinGW 的机器(或虚拟机)运行,确认不报缺 DLL。
  4. 用 windeployqt --dry-run 看它会复制哪些文件,再和实际目录对比。
  5. 用 Inno Setup 做一个最小安装包,故意在升级时保留配置目录,验证卸载后配置是否还在。

把这一套落到自己的项目上,建议先做一次「空目录复原」:找一台没有装 Qt、没有装编译器的机器,把发布目录整个拷过去,按 exe 是否启动、窗口是否出现、菜单和图片是否正常逐项记录。凡是启动失败,先用 dumpbin /dependents 或 objdump -p 看缺哪个 DLL,再回到 windeployqt 的日志里找它有没有被处理过。这个过程跑一次,比读十篇部署教程更能记住「exe 只是入口,目录才是程序」。第二遍再记录每个文件的大小,和 windeployqt 的输出逐项对上;目录里多出来的翻译文件、调试 DLL,能删的先删,删完必须重新启动一次,确认没有删掉运行时真正需要的模块。把清单存成文本,下次升级时对比差异,能看出新版本多带了哪个依赖,也能发现 windeployqt 漏掉的第三方 DLL。

下一篇讲版本升级与崩溃排查。装得上只是开始,用户还会升级、会崩溃。下一篇处理「升级后配置全丢」「旧 exe 被占用换不掉」「崩溃了但没有日志」这三类现场问题。