简介Qt5.15.12 的 Windows 10 32 位动态库版本由微软的 MSVC2019 编译器构建面向需要在 32 位 Windows 系统上部署 Qt 应用的开发者。该版本不包含 Qt WebEngine但保留 TLS 安全传输支持适合不需要内嵌浏览器的桌面应用软件压缩包内共有两千个文件绝大多数为 h 头文件配合动态链接库与导入库可为 Qt Core、Widgets、Network 等核心模块提供完整的编译与链接接口资源包整体约三百六十兆字节。动态库在运行时由多个程序共享能降低内存占用、方便模块化升级同时提供 Debug 与 Release 两种模式前者利于排查问题后者体积更小、运行更快。目前已有五百八十四人学习或下载。对初学者而言可省去手工编译 Qt 和配置 MSVC 环境的繁琐步骤直接引用这些经过预编译的库文件对老手来说也能快速搭建 32 位项目并遵循 LGPL 或商业许可完成发布。 做Windows 10下Qt的32位动态库编译这事看起来简单真折腾起来全是细节。特别是Qt 5.15.12这个版本明明官网下载页就有现成的32位安装包可项目偏偏要求在自家环境下用源码编译出32位动态库这就绕不开工具链匹配、依赖库准备、configure参数这几道坎。这篇就把我实际编译过程中踩过的坑、验证过的参数和最终能跑通的步骤完整写出来给有同样需求的朋友做个参考。1. 环境准备与工具链选型1.1 为什么还要源码编译32位动态库先说说这个需求的来源。Qt 5.15.12属于5.15 LTS分支修复了不少老漏洞在工业控制、医疗设备这类对稳定性要求高的场景里依然是主流选择。而需要自己编译32位动态库通常不外乎两个原因一是目标设备还是32位嵌入式Windows或老工控机必须跑x86架构的程序二是项目里接了第三方32位闭源库比如某个加密狗SDK或采集卡驱动主程序哪怕跑在64位系统上也得用32位Qt才能跟这些库链到一块儿。动态库方案的优势不用多说部署体积比静态库小得多升级某个模块只需要替换对应DLL不至于整个重新发布。但代价就是必须把所有依赖理清楚编译器、链接器、OpenSSL、ICU这些都得按32位来配对一步错后面全错。1.2 工具链选择MSVC 2019还是MinGWQt 5.15.12在Windows下支持两套工具链MSVC和MinGW。我推荐用MSVC 2019原因很实在官方发布的Qt二进制安装包默认就是MSVC版本生态兼容性最好后续如果要加装第三方模块不会出现ABI不匹配的问题。调试体验好VS的图形化调试器比GDB在Windows上的表现稳定太多。编译出的程序依赖VCRUNTIME运行库目标机器装个VC Redistributable就好这在工业环境里属于常规操作。MinGW的好处是开源、不需要Visual Studio授权但坑也不少。最典型的是部分第三方库只提供MSVC版本的.libMinGW用起来还得转换格式得不偿失。所以除非公司对开源协议有硬性要求否则MSVC 2019是32位编译的首选。环境清单列一下操作系统Windows 10 21H2及以上建议64位系统32位系统内存上限在那编译大项目很容易爆内存。开发环境Visual Studio 2019安装时勾选“使用C的桌面开发”工作负载注意在“单个组件”里确认勾选了“适用于最新v142生成工具的C x86/x64生成工具”。工具链环境必须使用“x86 Native Tools Command Prompt for VS2019”不是普通的开发者命令提示符也不是x64版本。这个细节决定configure阶段能否正确识别编译器架构。依赖工具Perl推荐Strawberry Perl 5.32.x、Python 3.7~3.9Qt官方构建脚本需要、Ruby可选的只在构建某些文档模块时需要。这里我推荐顺序是先装Visual Studio并验证x86编译环境再装Perl和Python最后准备Qt源码。验证x86工具链的命令很简单cl如果输出“Microsoft (R) C/C Optimizing Compiler Version 19.29.30133 for x86”说明x86编译环境没问题。2. 源码下载与configure参数逐项解析2.1 Qt 5.15.12源码获取方式Qt源码有两种拿法一种是从Qt官网的镜像下载页面直接下载qt-everywhere-opensource-src-5.15.12.zip另一种是用git拉取。我建议用压缩包原因有二压缩包体积约500MB解压后带.git目录反而增加磁盘占用。git拉取需要先fetch整个仓库历史网络不稳定的情况下容易中断而压缩包支持断点续传。下载完成后建议解压到不带空格的路径比如D:\Qt\src\qt-5.15.12。我之前试过解压到D:\Program Files\Qt\下面configure阶段直接报警告因为路径中的空格会导致某些makefile规则失效。这是Windows平台的老毛病宁可信其有。2.2 configure参数怎么选32位动态库的核心配置进入D:\Qt\src\qt-5.15.12\qtbase目录执行configure。这里我给出一个实测验证过的参数组合按场景拆解configure.bat -platform win32-msvc -target x86 -opensource -confirm-license -shared -prefix D:\Qt\5.15.12\msvc2019 -nomake examples -nomake tests -no-opengl -skip qtwebengine -skip qt3d -skip qtcharts -skip qtdoc -skip qtimageformats -skip qtserialbus -skip qtserialport -skip qtnetworkauth -skip qtquick3d -skip qtwebglplugin -skip qtwebview -skip qtwinextras -openssl-linked OPENSSL_PREFIXD:\Qt\dev\openssl-1.1.1w-x86逐项说明关键参数的含义和选择理由-platform win32-msvc指定构建平台为Windows 32位MSVC。这个参数直接决定编译器的调用方式如果漏掉Qt默认按64位构建后面所有库都会白编。-target x86明确目标架构是x86。有些版本的Qt编译器工具链是x64的但目标平台要编x86就需要显式指定。-shared生成动态库DLL。静态库用-static但前面说过动态库更适合这个场景。-prefix D:\Qt\5.15.12\msvc2019安装路径。这个路径后面nmake install阶段会用到建议规划好因为编译完成后这里的文件就是最终部署的Qt运行时。-no-opengl禁用OpenGL模块。工业设备上不一定有独立显卡软件渲染优先。如果项目里确实需要OpenGL去掉这个参数即可但需要提前确认目标机器显卡驱动支持情况。-skip qtwebengineQt WebEngine模块在32位下官方已经放弃维护直接跳过不然编译到一半报错会浪费大量时间。-openssl-linked链接OpenSSL库并指定前缀路径。注意这里要用OPENSSL_PREFIX明确指定32位版OpenSSL的安装位置这个放在后面详细说。configure执行成功后终端会打印一份配置摘要包含Qt版本、构建方式、安装前缀等信息。务必检查一下“Architecture”一栏是否显示x86以及“OpenSSL”是否显示yes。如果这两项不对后续会返工。2.3 OpenSSL、ICU等第三方库的32位注意事项OpenSSL是这里最大的变量。Qt里SSL功能默认是动态加载也就是说编译时不需要OpenSSL头文件和库文件只在运行时通过qputenv(QT_SSL_USE_OPENSSL, 1)去加载系统里的libssl-1_1.dll和libcrypto-1_1.dll。但这种方式在部署时很容易漏DLL所以我建议用-openssl-linked把OpenSSL直接链进Qt的DLL里部署时少一个隐患。OpenSSL的32位版本需要自己用Perl编译。具体步骤可以这样来perl Configure VC-WIN32 no-asm --prefixD:\Qt\dev\openssl-1.1.1w-x86 nmake nmake install编译OpenSSL时注意两点一是必须用x86 Native Tools Command Prompt打开命令行因为VC-WIN32配置会根据当前命令行环境自动选择编译器二是建议加no-asm参数虽然会损失一点加密性能但能省去汇编编译器的配置麻烦工业场景对性能不那么敏感稳定优先。ICUInternational Components for Unicode库国内项目用得少很多场景用不到如果不需要就直接加-no-icu参数跳过。如果项目涉及国际化字符串处理需要提前编译32位ICU库并且用ICU_PREFIX参数指定路径。这里我建议能跳就跳因为ICU的编译复杂度比OpenSSL还高对编译器的版本也非常敏感。3. 编译过程与核心环节实现3.1 分模块编译策略为什么建议单独配置和编译全量编译Qt 5.15.12在四核i5处理器、16GB内存的机器上大约需要3到4个小时。而很多项目其实只需要核心模块和部分附加模块没必要全编。这时候就可以用qtbase单独构建再按需构建其他模块。具体操作方式是先在D:\Qt\src\qt-5.15.12\qtbase目录执行configure只编译Qt的核心库和基本模块包括QtCore、QtGui、QtWidgets、QtNetwork等。这些基本覆盖了90%的桌面应用场景。configure完执行nmake nmake installnmake期间终端会有大量编译输出如果机器只有一个屏幕建议把输出重定向到日志文件例如nmake build.log 21这样即使编译中断也好排查具体是哪个模块出的问题。qtbase编译安装完成后再进入其他需要的模块目录比如D:\Qt\src\qt-5.15.12\qtsvg单独执行qmake、nmake、nmake install。这个方式的好处是出问题时能精确定位模块不用每次都在几千行日志里翻。3.2 实测编译流程与关键检查点我这里跑过一次完整的编译流程做个简单记录。环境是Windows 10专业版22H2i7-10700K处理器32GB内存固态硬盘。第一步验证工具链。打开x86 Native Tools Command Prompt输入cl和nmake确认都能识别。PATH环境变量里需要确认包含VS的VC\Tools\MSVC目录下对应x86的bin路径这一步通常装完VS会自动配好。第二步在qtbase目录下运行上面那组configure参数。configure阶段耗时大概5分钟中间会输出大量检测信息比如编译器是否正常、依赖库是否找到。看到类似Qt is now configured for building的提示就算成功。第三步执行nmake。这一步在固态硬盘上耗时约1小时40分钟。期间如果CPU占用率掉到0%大概率是编译报错卡住了需要检查终端输出或者日志文件。常见的是WebEngine模块的编译报错幸好我们前面已经skip掉了。第四步nmake install。这一步就是把编译好的库、头文件、插件拷贝到prefix目录耗时几分钟。安装完成后检查一下D:\Qt\5.15.12\msvc2019\bin目录里面应该有Qt5Core.dll、Qt5Gui.dll、Qt5Widgets.dll等动态库文件注意到这里没有Qt5WebEngine.dll就说明我们跳过的模块确实没有被安装。3.3 用windeployqt验证部署环境的完整性编译安装完成后弄个测试程序验证部署。写一个最简单的Qt Widgets程序在项目目录下执行qtbase相关环境配置D:\Qt\5.15.12\msvc2019\bin\qmake --version确认qmake输出的Qt版本和架构是5.15.12和x86。然后构建测试程序最后用windeployqt打包D:\Qt\5.15.12\msvc2019\bin\windeployqt.exe Debug\demo.exewindeployqt会自动把依赖的Qt DLL、platforms插件、styles插件复制到exe所在目录。这里有个常见坑windeployqt默认按当前系统的架构拷贝DLL如果当前是64位系统它可能会拷出64位库导致运行时报错。解决方法是确认windeployqt本身是32位版本位于32位prefix目录下并且用命令行指定--x86参数。我在实际验证时一般会额外在目标机器上装一个32位Windows系统做最终测试确保平台插件加载正常。4. 常见问题与排查技巧实录4.1 configure阶段典型报错配置阶段最容易出现的报错是编译器架构识别错误。最典型的提示是ERROR: Cannot detect architecture for compiler原因通常是环境变量里的编译器是x64版本而configure想配置x86平台。解决办法只有一条重新打开x86 Native Tools Command Prompt确保命令行提示符里显示的是“x86 Native Tools Command Prompt”而不是“x64 Native Tools Command Prompt”。另一个经常遇到的是Perl版本过低或缺失ERROR: Perl not found. Please install Perl and add it to your PATH.这个就必须安装Strawberry Perl并且确保安装时勾选了“Add Perl to the PATH environment variable”。有个坑是系统里装了多个Perl比如Git自带的Perl或者公司安全软件自带的Perl路径顺序会影响configure的判断。建议把Strawberry Perl的路径放到系统PATH最前面。4.2 编译阶段最常见的问题nmake阶段最烦人的错误是链接失败常见报错形如LNK1181: cannot open input file libssl.lib原因就是OpenSSL库路径不对。检查OPENSSL_PREFIX参数指向的目录下是否存在lib\libssl.lib。另一个相关的问题是32位OpenSSL库编译成了64位这个可以用dumpbin /headers查看PE头来判断。还有一类是内存不足导致的编译中断比如c1xx : fatal error C1060: compiler is out of heap space典型原因是32位编译器进程的最大内存为2GB当单个编译单元比如qwidget.cpp过大时就会爆掉。解决方法是加/MP多进程编译参数或者把CL环境变量设为/Zm800来扩大编译器的堆内存上限。实测/Zm800对Qt这种大型源码效果显著。4.3 部署阶段最容易忽略的细节动态库编译完成部署时最容易忽略的是编译器的运行库。MSVC编译的Qt DLL依赖VCRUNTIME140.dll目标机器如果没有安装VC Redistributable程序会直接报“找不到VCRUNTIME140.dll”而且这个报错在开发机上很难复现因为开发机装了VS自带运行库。另外就是插件目录问题。Qt的程序运行时需要platforms目录下有qwindows.dll插件目录结构必须是exe所在目录\platforms\qwindows.dll不能放在其他位置。windeployqt会处理好这个结构但手动拷贝时经常漏掉。排查这个问题最直观的方法是看程序启动时是否报no qt platform plugin could be initialized错误。我把这几个典型问题整理成一个速查表问题现象大概率原因解决办法configure提示Cannot detect architecture命令行不是x86环境重新打开x86 Native Tools Command PromptLNK1181无法打开libssl.libOpenSSL路径不对或32位版本缺失检查OPENSSL_PREFIX路径重新编译OpenSSLC1060编译堆内存不足单个编译单元过大设置CL/Zm800环境变量运行时报no qt platform pluginplatforms插件目录缺失拷贝\platforms\qwindows.dll到exe目录下目标机器缺VCRUNTIME140.dll未安装运行库部署VC 2019 Redistributable x864.4 独家避坑经验别在模块上贪多最后分享一个经验。Qt 5.15.12的源码包解压后包含几十个模块但不是每个模块都适合编译。60%的模块我们这辈子可能都用不上比如qtquick3d、qtwebengine、qtvirtualkeyboard。这些模块不仅编译时间长而且对系统环境要求苛刻动不动就编译失败。我在选择模块时基本只保留qtbase、qtsvg、qttools、qttranslations、qtmultimedia如果项目需要、qtserialport如果做串口其他用不到的模块全部-skip。这样编译时间从3小时缩短到2小时左右成功率也大幅提升。另外一个容易被忽略的问题是磁盘空间。Qt 5.15.12源码解压后约1.5GB编译产物和安装目录还会占用4到5GB。如果C盘空间紧张配置时记得用-prefix指定到其他分区比如D:\Qt\5.15.12\msvc2019编译过程中的临时文件也需要预留2GB以上空间否则nmake会在半途报磁盘已满。这一点看似简单我见过不止一个人栽在上面编译了俩小时突然报错就是磁盘满了。本文还有配套的精品资源点击获取
Windows 10下源码编译Qt 5.15.12 32位动态库完整指南
简介Qt5.15.12 的 Windows 10 32 位动态库版本由微软的 MSVC2019 编译器构建面向需要在 32 位 Windows 系统上部署 Qt 应用的开发者。该版本不包含 Qt WebEngine但保留 TLS 安全传输支持适合不需要内嵌浏览器的桌面应用软件压缩包内共有两千个文件绝大多数为 h 头文件配合动态链接库与导入库可为 Qt Core、Widgets、Network 等核心模块提供完整的编译与链接接口资源包整体约三百六十兆字节。动态库在运行时由多个程序共享能降低内存占用、方便模块化升级同时提供 Debug 与 Release 两种模式前者利于排查问题后者体积更小、运行更快。目前已有五百八十四人学习或下载。对初学者而言可省去手工编译 Qt 和配置 MSVC 环境的繁琐步骤直接引用这些经过预编译的库文件对老手来说也能快速搭建 32 位项目并遵循 LGPL 或商业许可完成发布。 做Windows 10下Qt的32位动态库编译这事看起来简单真折腾起来全是细节。特别是Qt 5.15.12这个版本明明官网下载页就有现成的32位安装包可项目偏偏要求在自家环境下用源码编译出32位动态库这就绕不开工具链匹配、依赖库准备、configure参数这几道坎。这篇就把我实际编译过程中踩过的坑、验证过的参数和最终能跑通的步骤完整写出来给有同样需求的朋友做个参考。1. 环境准备与工具链选型1.1 为什么还要源码编译32位动态库先说说这个需求的来源。Qt 5.15.12属于5.15 LTS分支修复了不少老漏洞在工业控制、医疗设备这类对稳定性要求高的场景里依然是主流选择。而需要自己编译32位动态库通常不外乎两个原因一是目标设备还是32位嵌入式Windows或老工控机必须跑x86架构的程序二是项目里接了第三方32位闭源库比如某个加密狗SDK或采集卡驱动主程序哪怕跑在64位系统上也得用32位Qt才能跟这些库链到一块儿。动态库方案的优势不用多说部署体积比静态库小得多升级某个模块只需要替换对应DLL不至于整个重新发布。但代价就是必须把所有依赖理清楚编译器、链接器、OpenSSL、ICU这些都得按32位来配对一步错后面全错。1.2 工具链选择MSVC 2019还是MinGWQt 5.15.12在Windows下支持两套工具链MSVC和MinGW。我推荐用MSVC 2019原因很实在官方发布的Qt二进制安装包默认就是MSVC版本生态兼容性最好后续如果要加装第三方模块不会出现ABI不匹配的问题。调试体验好VS的图形化调试器比GDB在Windows上的表现稳定太多。编译出的程序依赖VCRUNTIME运行库目标机器装个VC Redistributable就好这在工业环境里属于常规操作。MinGW的好处是开源、不需要Visual Studio授权但坑也不少。最典型的是部分第三方库只提供MSVC版本的.libMinGW用起来还得转换格式得不偿失。所以除非公司对开源协议有硬性要求否则MSVC 2019是32位编译的首选。环境清单列一下操作系统Windows 10 21H2及以上建议64位系统32位系统内存上限在那编译大项目很容易爆内存。开发环境Visual Studio 2019安装时勾选“使用C的桌面开发”工作负载注意在“单个组件”里确认勾选了“适用于最新v142生成工具的C x86/x64生成工具”。工具链环境必须使用“x86 Native Tools Command Prompt for VS2019”不是普通的开发者命令提示符也不是x64版本。这个细节决定configure阶段能否正确识别编译器架构。依赖工具Perl推荐Strawberry Perl 5.32.x、Python 3.7~3.9Qt官方构建脚本需要、Ruby可选的只在构建某些文档模块时需要。这里我推荐顺序是先装Visual Studio并验证x86编译环境再装Perl和Python最后准备Qt源码。验证x86工具链的命令很简单cl如果输出“Microsoft (R) C/C Optimizing Compiler Version 19.29.30133 for x86”说明x86编译环境没问题。2. 源码下载与configure参数逐项解析2.1 Qt 5.15.12源码获取方式Qt源码有两种拿法一种是从Qt官网的镜像下载页面直接下载qt-everywhere-opensource-src-5.15.12.zip另一种是用git拉取。我建议用压缩包原因有二压缩包体积约500MB解压后带.git目录反而增加磁盘占用。git拉取需要先fetch整个仓库历史网络不稳定的情况下容易中断而压缩包支持断点续传。下载完成后建议解压到不带空格的路径比如D:\Qt\src\qt-5.15.12。我之前试过解压到D:\Program Files\Qt\下面configure阶段直接报警告因为路径中的空格会导致某些makefile规则失效。这是Windows平台的老毛病宁可信其有。2.2 configure参数怎么选32位动态库的核心配置进入D:\Qt\src\qt-5.15.12\qtbase目录执行configure。这里我给出一个实测验证过的参数组合按场景拆解configure.bat -platform win32-msvc -target x86 -opensource -confirm-license -shared -prefix D:\Qt\5.15.12\msvc2019 -nomake examples -nomake tests -no-opengl -skip qtwebengine -skip qt3d -skip qtcharts -skip qtdoc -skip qtimageformats -skip qtserialbus -skip qtserialport -skip qtnetworkauth -skip qtquick3d -skip qtwebglplugin -skip qtwebview -skip qtwinextras -openssl-linked OPENSSL_PREFIXD:\Qt\dev\openssl-1.1.1w-x86逐项说明关键参数的含义和选择理由-platform win32-msvc指定构建平台为Windows 32位MSVC。这个参数直接决定编译器的调用方式如果漏掉Qt默认按64位构建后面所有库都会白编。-target x86明确目标架构是x86。有些版本的Qt编译器工具链是x64的但目标平台要编x86就需要显式指定。-shared生成动态库DLL。静态库用-static但前面说过动态库更适合这个场景。-prefix D:\Qt\5.15.12\msvc2019安装路径。这个路径后面nmake install阶段会用到建议规划好因为编译完成后这里的文件就是最终部署的Qt运行时。-no-opengl禁用OpenGL模块。工业设备上不一定有独立显卡软件渲染优先。如果项目里确实需要OpenGL去掉这个参数即可但需要提前确认目标机器显卡驱动支持情况。-skip qtwebengineQt WebEngine模块在32位下官方已经放弃维护直接跳过不然编译到一半报错会浪费大量时间。-openssl-linked链接OpenSSL库并指定前缀路径。注意这里要用OPENSSL_PREFIX明确指定32位版OpenSSL的安装位置这个放在后面详细说。configure执行成功后终端会打印一份配置摘要包含Qt版本、构建方式、安装前缀等信息。务必检查一下“Architecture”一栏是否显示x86以及“OpenSSL”是否显示yes。如果这两项不对后续会返工。2.3 OpenSSL、ICU等第三方库的32位注意事项OpenSSL是这里最大的变量。Qt里SSL功能默认是动态加载也就是说编译时不需要OpenSSL头文件和库文件只在运行时通过qputenv(QT_SSL_USE_OPENSSL, 1)去加载系统里的libssl-1_1.dll和libcrypto-1_1.dll。但这种方式在部署时很容易漏DLL所以我建议用-openssl-linked把OpenSSL直接链进Qt的DLL里部署时少一个隐患。OpenSSL的32位版本需要自己用Perl编译。具体步骤可以这样来perl Configure VC-WIN32 no-asm --prefixD:\Qt\dev\openssl-1.1.1w-x86 nmake nmake install编译OpenSSL时注意两点一是必须用x86 Native Tools Command Prompt打开命令行因为VC-WIN32配置会根据当前命令行环境自动选择编译器二是建议加no-asm参数虽然会损失一点加密性能但能省去汇编编译器的配置麻烦工业场景对性能不那么敏感稳定优先。ICUInternational Components for Unicode库国内项目用得少很多场景用不到如果不需要就直接加-no-icu参数跳过。如果项目涉及国际化字符串处理需要提前编译32位ICU库并且用ICU_PREFIX参数指定路径。这里我建议能跳就跳因为ICU的编译复杂度比OpenSSL还高对编译器的版本也非常敏感。3. 编译过程与核心环节实现3.1 分模块编译策略为什么建议单独配置和编译全量编译Qt 5.15.12在四核i5处理器、16GB内存的机器上大约需要3到4个小时。而很多项目其实只需要核心模块和部分附加模块没必要全编。这时候就可以用qtbase单独构建再按需构建其他模块。具体操作方式是先在D:\Qt\src\qt-5.15.12\qtbase目录执行configure只编译Qt的核心库和基本模块包括QtCore、QtGui、QtWidgets、QtNetwork等。这些基本覆盖了90%的桌面应用场景。configure完执行nmake nmake installnmake期间终端会有大量编译输出如果机器只有一个屏幕建议把输出重定向到日志文件例如nmake build.log 21这样即使编译中断也好排查具体是哪个模块出的问题。qtbase编译安装完成后再进入其他需要的模块目录比如D:\Qt\src\qt-5.15.12\qtsvg单独执行qmake、nmake、nmake install。这个方式的好处是出问题时能精确定位模块不用每次都在几千行日志里翻。3.2 实测编译流程与关键检查点我这里跑过一次完整的编译流程做个简单记录。环境是Windows 10专业版22H2i7-10700K处理器32GB内存固态硬盘。第一步验证工具链。打开x86 Native Tools Command Prompt输入cl和nmake确认都能识别。PATH环境变量里需要确认包含VS的VC\Tools\MSVC目录下对应x86的bin路径这一步通常装完VS会自动配好。第二步在qtbase目录下运行上面那组configure参数。configure阶段耗时大概5分钟中间会输出大量检测信息比如编译器是否正常、依赖库是否找到。看到类似Qt is now configured for building的提示就算成功。第三步执行nmake。这一步在固态硬盘上耗时约1小时40分钟。期间如果CPU占用率掉到0%大概率是编译报错卡住了需要检查终端输出或者日志文件。常见的是WebEngine模块的编译报错幸好我们前面已经skip掉了。第四步nmake install。这一步就是把编译好的库、头文件、插件拷贝到prefix目录耗时几分钟。安装完成后检查一下D:\Qt\5.15.12\msvc2019\bin目录里面应该有Qt5Core.dll、Qt5Gui.dll、Qt5Widgets.dll等动态库文件注意到这里没有Qt5WebEngine.dll就说明我们跳过的模块确实没有被安装。3.3 用windeployqt验证部署环境的完整性编译安装完成后弄个测试程序验证部署。写一个最简单的Qt Widgets程序在项目目录下执行qtbase相关环境配置D:\Qt\5.15.12\msvc2019\bin\qmake --version确认qmake输出的Qt版本和架构是5.15.12和x86。然后构建测试程序最后用windeployqt打包D:\Qt\5.15.12\msvc2019\bin\windeployqt.exe Debug\demo.exewindeployqt会自动把依赖的Qt DLL、platforms插件、styles插件复制到exe所在目录。这里有个常见坑windeployqt默认按当前系统的架构拷贝DLL如果当前是64位系统它可能会拷出64位库导致运行时报错。解决方法是确认windeployqt本身是32位版本位于32位prefix目录下并且用命令行指定--x86参数。我在实际验证时一般会额外在目标机器上装一个32位Windows系统做最终测试确保平台插件加载正常。4. 常见问题与排查技巧实录4.1 configure阶段典型报错配置阶段最容易出现的报错是编译器架构识别错误。最典型的提示是ERROR: Cannot detect architecture for compiler原因通常是环境变量里的编译器是x64版本而configure想配置x86平台。解决办法只有一条重新打开x86 Native Tools Command Prompt确保命令行提示符里显示的是“x86 Native Tools Command Prompt”而不是“x64 Native Tools Command Prompt”。另一个经常遇到的是Perl版本过低或缺失ERROR: Perl not found. Please install Perl and add it to your PATH.这个就必须安装Strawberry Perl并且确保安装时勾选了“Add Perl to the PATH environment variable”。有个坑是系统里装了多个Perl比如Git自带的Perl或者公司安全软件自带的Perl路径顺序会影响configure的判断。建议把Strawberry Perl的路径放到系统PATH最前面。4.2 编译阶段最常见的问题nmake阶段最烦人的错误是链接失败常见报错形如LNK1181: cannot open input file libssl.lib原因就是OpenSSL库路径不对。检查OPENSSL_PREFIX参数指向的目录下是否存在lib\libssl.lib。另一个相关的问题是32位OpenSSL库编译成了64位这个可以用dumpbin /headers查看PE头来判断。还有一类是内存不足导致的编译中断比如c1xx : fatal error C1060: compiler is out of heap space典型原因是32位编译器进程的最大内存为2GB当单个编译单元比如qwidget.cpp过大时就会爆掉。解决方法是加/MP多进程编译参数或者把CL环境变量设为/Zm800来扩大编译器的堆内存上限。实测/Zm800对Qt这种大型源码效果显著。4.3 部署阶段最容易忽略的细节动态库编译完成部署时最容易忽略的是编译器的运行库。MSVC编译的Qt DLL依赖VCRUNTIME140.dll目标机器如果没有安装VC Redistributable程序会直接报“找不到VCRUNTIME140.dll”而且这个报错在开发机上很难复现因为开发机装了VS自带运行库。另外就是插件目录问题。Qt的程序运行时需要platforms目录下有qwindows.dll插件目录结构必须是exe所在目录\platforms\qwindows.dll不能放在其他位置。windeployqt会处理好这个结构但手动拷贝时经常漏掉。排查这个问题最直观的方法是看程序启动时是否报no qt platform plugin could be initialized错误。我把这几个典型问题整理成一个速查表问题现象大概率原因解决办法configure提示Cannot detect architecture命令行不是x86环境重新打开x86 Native Tools Command PromptLNK1181无法打开libssl.libOpenSSL路径不对或32位版本缺失检查OPENSSL_PREFIX路径重新编译OpenSSLC1060编译堆内存不足单个编译单元过大设置CL/Zm800环境变量运行时报no qt platform pluginplatforms插件目录缺失拷贝\platforms\qwindows.dll到exe目录下目标机器缺VCRUNTIME140.dll未安装运行库部署VC 2019 Redistributable x864.4 独家避坑经验别在模块上贪多最后分享一个经验。Qt 5.15.12的源码包解压后包含几十个模块但不是每个模块都适合编译。60%的模块我们这辈子可能都用不上比如qtquick3d、qtwebengine、qtvirtualkeyboard。这些模块不仅编译时间长而且对系统环境要求苛刻动不动就编译失败。我在选择模块时基本只保留qtbase、qtsvg、qttools、qttranslations、qtmultimedia如果项目需要、qtserialport如果做串口其他用不到的模块全部-skip。这样编译时间从3小时缩短到2小时左右成功率也大幅提升。另外一个容易被忽略的问题是磁盘空间。Qt 5.15.12源码解压后约1.5GB编译产物和安装目录还会占用4到5GB。如果C盘空间紧张配置时记得用-prefix指定到其他分区比如D:\Qt\5.15.12\msvc2019编译过程中的临时文件也需要预留2GB以上空间否则nmake会在半途报磁盘已满。这一点看似简单我见过不止一个人栽在上面编译了俩小时突然报错就是磁盘满了。本文还有配套的精品资源点击获取
