过去几年我一直用着 Qt 5.15.2从 Windows 10 换到 Windows 11 之后又新装了两台机器都是走的在线安装器这条路。说实话这版本没到“装一次就再无波澜”的程度但只要你理解它背后的逻辑每一步都知道要做什么整个流程还是挺顺利的。这篇就把我在 Windows 11 上安装 Qt 5.15.2 的完整思路和操作过程写下来包括在线安装器里每一项都是干什么的、装完怎么让 Qt Creator 能认到工具链、以及新手最容易卡住的几个地方。无论你是头一回接触 Qt还是从 Qt 6 临时转回来维护老项目照着这套流程走基本都能落地。1. 为什么绕不开 5.15.2开源版本的现实选择1.1 你对 Qt 版本的执念是哪来的不少朋友是在 Qt 6 发布之后才开始关注 5.15.2 的。Qt 6 确实新但大量存量项目、教程、第三方库都还停留在 Qt 5 生态里。尤其是工控、桌面工具这类讲究稳定的场景团队不愿意因为升级框架去做回归测试。5.15 是 Qt 5 分支里最后的 LTS 长周期支持版本而其中5.15.2 又是官方在线安装器里开源用户能直接拿到的最后一个补丁版本之后再想装 5.15 系列的更新要么走商业授权要么从社区补丁源码自己编。这个事实让我当初选 5.15.2 时非常明确它不是“最新”但它是开源渠道里最省事的稳定点。1.2 在线安装器到底比离线包强在哪Qt 官方的在线安装器本质上是一个带账户认证的组件管理器。下载下来只是几十 MB 的启动程序真正的大块头是在安装过程中按需拉取。离线包虽然一次下载一个完整压缩包但体积动辄好几个 GB而且开源组件和附加模块的入口越来越隐蔽。你还会遇到一个很实际的问题离线包装完想加一个 Qt Charts 模块要么重新找完整包要么重新下载相当僵硬。在线安装器则是想加什么加什么版本库也始终跟官方线上清单保持一致这也是为什么我在 Windows 11 上推荐在线安装的理由。2. 在线安装前后最该确认的四件事2.1 Windows 11 系统版本和 CPU 架构不要理所当然地觉得自己的电脑就是 x64。现在 ARM 架构的 Windows 11 设备已经不少了。Qt 官方在线安装器有专门区分 x64 和 ARM64 的版本如果你拿了 x64 安装器往 ARM 机器上跑后面的组件选择里很可能会出现不完整或者干脆无法启动 Qt Creator 的情况。我自己都是先在“设置 → 系统 → 系统信息”里看一眼处理器架构再动手。系统版本方面Windows 11 的 22H2、23H2 直到 24H2 我都实测过Qt 5.15.2 本身没有兼容性问题但前提是你给它的依赖环境版本别太旧。如果你系统一直开着自动更新一般不用为此操心。2.2 Visual Studio 工具链装完整版还是 Build ToolsQt 5.15.2 官方预编译的 Windows 库分两套主流方案MSVC 系和 MinGW 系。MinGW 用 GCC 工具链简单但调试体验相对有限MSVC 能配合 Visual Studio 家族的调试器工程上更常见。装 Qt 和 Visual Studio 并不是强绑定关系但你必须保证系统里至少有一套编译器否则 Qt Creator 装完也编不了任何东西。完整版的 Visual Studio 社区版是免费且最稳的选择。安装时勾选“使用 C 的桌面开发”里面会带 MSVC 编译器和 Windows SDK。要是你硬盘吃紧也可以只装 Build Tools但组件勾选上更容易漏我见过好几回装完 Build Tools 之后 Qt Creator 死活识别不到编译器的例子最后都是回去补装组件解决的。所以新机器我通常直接上完整版社区版省得坑自己。2.3 先注册好 Qt 账户再开始安装在线安装器的登录环节是躲不掉的。Qt 官网注册账户免费填个邮箱收验证邮件就能用。有一点提醒如果你在公司或学校网络环境里邮件验证有时会滞后提前个十分钟做这一步别等到安装器跑起来才临时收邮件。注册时选“开源用户”身份就好安装器里对应勾选开源协议相关条目即可。2.4 磁盘空间和安装目录规划Qt 的安装不光是 Qt 本身还有 Qt Creator、额外的模块、调试符号这几个加起来常常突破 10 GB。C 盘如果是系统盘且剩余空间比较紧张安装路径建议选择非系统分区。Qt 官方的默认路径是C:\Qt我在一台机器上把它改成了D:\QtLib\Qt后续没有任何副作用只是 Qt Creator 启动时第一次要你手动定位一下。提示安装目录路径里最好不要带中文和空格虽然 Qt 对空格支持还行但后面有些自定义脚本、CI 脚本处理起来容易踩坑能避开就避开。3. 在线安装器实战从登录到组件清单逐项拆解3.1 登录、协议和安装位置的选择逻辑双击运行在线安装器之后一路点 Next会到 Qt Account 登录页。输入账号密码后安装器会反问你是否同意开源协议。这里注意开源用户应当选“我不需要商业服务/我是开源用户”这类条目对应的选项安装器才会展示对应的开源组件包。之后会让你选安装路径和关联哪些组件。安装路径我前面提过尽量避开系统盘中文路径。组件列表是整个安装过程里最容易让新手懵的地方下面单独详细说。3.2 组件树里每个节点到底是什么含义组件树默认分几大类Qt、Qt Creator、Qt Debug Symbols、Developer and Designer Tools等。很多人一进来看见 Qt 5.15.2 底下密密麻麻一堆复选框直接蒙了。我把我的勾选思路整理成一个清单组件节点建议勾选理由Qt 5.15.2 → MSVC 2019 64-bit是主编译套件配合 Visual Studio 工具链最稳Qt 5.15.2 → MSVC 2019 32-bit视需求需要产出 32 位程序才勾日常 64 位为主Qt 5.15.2 → MinGW 8.1.0 64-bit可选是想用轻量 GCC 链条时再勾二选一思想Qt 5.15.2 → Qt Charts按项目画图做统计界面才需要不需要别浪费空间Qt 5.15.2 → Qt WebEngine尽量不勾体积大、依赖多普通桌面程序用不到Qt Creator是开发时主要 IDE不装它纯命令行会很累Qt Debug Symbols推荐勾调试时需要符号才能定位得更准Developer and Designer Tools → Qt Designer可按需画 .ui 界面用Qt Creator 也内嵌了编辑器这里面的“MSVC 2019 64-bit”是很多朋友困惑的点Visual Studio 2022 都出了Qt 5.15.2 只提供 MSVC 2019 的二进制确实是这样。Qt 5.15.2 官方用 MSVC 2019 编译发布了预编译库你在 Windows 11 VS2022 环境下编译 Qt 5.15.2 程序时编译器版本不一样其实没问题MSVC 之前和后代的二进制兼容性比较好。不过我见过一个反例有人只装了 VS2022没装任何 MSVC 2019 工具集Qt Creator 自动检测时不认最终通过在 VS Installer 里补装“MSVC v142 生成工具”解决。所以你在装 VS 的时候顺手把“适用于最新 VS 的 C 工具”那几项都留着比后面折腾强。3.3 安装进度条卡住别急着关在线安装最考验耐心的是下载过程。组件多的情况下进度条卡在某个百分比不动很常见尤其是像 Qt WebEngine 这种大模块。我的经验是先等 3 到 5 分钟同时观察任务管理器里 Installer 进程的网络和磁盘活动。如果网络还在持续流量那它只是慢不是在死如果流量彻底归零再考虑取消并重新运行安装器。在线安装器的好处是已下载的成果通常会缓存重开之后能接着用不会真从零开始。所以看到卡住别慌也别反复掐断进程给它一个干净的出口。4. 装完只是开始Qt Creator 工具链配置才是成败关键4.1 首次启动时提示 No Kits Found 怎么办安装完成后第一件事不是急着写代码而是先确认 Qt Creator 能不能识别出完整套件。首次启动时它会自动扫描系统中的编译器、调试器、Qt 版本。如果界面底部的 Kit 列表是空的最常见的两大原因一是 VS 安装的组件不完整导致编译器没被找到二是 Qt 安装和 VS 安装的先后顺序问题导致自动检测失灵。处理办法是让 Qt Creator 手动重新扫描或者直接在工具里手动添加。在“工具 → 选项 → Kits → Qt Versions”页面里把那个失效的 qmake 路径重新指向你的 Qt 安装目录下对应套件的 qmake.exe比如D:\QtLib\Qt\5.15.2\msvc2019_64\bin\qmake.exe。然后在“编译器”页面里添加 MSVC 编译器再把 Kit 页面上对应的编译器、调试器、Qt 版本关联起来。4.2 调试器补装Debug 不出窗口的典型原因Windows 上 Qt 程序的调试器默认推荐 Windows SDK 里附带的 CDB。**如果 VS 安装时没有勾选“Debugging Tools for Windows”你会发现程序能编译能运行但一按 F5 就提示缺少调试器。**这个坑很隐蔽因为不调试的人根本不会注意。解决方式是打开 Visual Studio Installer修改安装选项在“单个组件”下找出 Windows 调试工具勾上再装。装完回 Qt Creator 的 Kits 里重新检测调试器会自动出现。这个细节我至少三次帮朋友定位到属于那种“看教程没人提遇到才知道”的问题。4.3 环境变量设置到底有没有必要网上不少教程强调装完 Qt 必须把C:\Qt\5.15.2\msvc2019_64\bin加到系统的 PATH 环境变量。实际上如果你只在 Qt Creator 里开发不设置也完全正常因为 Creator 管理的是 qmake 的绝对路径不依赖 PATH。只有当你要在命令行里直接跑qmake、windeployqt或者接入了自定义构建脚本时才需要手动配置。假设你需要命令行工具链可以这样加到 PATHD:\QtLib\Qt\5.15.2\msvc2019_64\bin注意别同时给机器里装的两个 Qt 版本都加 PATH那样命令行里出来的不一定是你想要的那个 qmake。环境变量这种东西能少动就少动尤其不要因为教程说“应该加”就加。5. 跑通第一个程序验证 Windows 11 Qt 5.15.2 组合是否健康5.1 新建一个最小 Widgets 工程配置好 Kit 之后我习惯先建一个最小工程验证整条链路。Qt Creator 里选择“Application → Qt Widgets Application”构建套件选Desktop Qt 5.15.2 MSVC2019_64一路默认。下面这段就是标准的入口代码Qt 5.15.2 在 Windows 11 高 DPI 屏幕上建议开头就启用高 DPI 缩放否则界面会发糊#include QApplication #include QWidget int main(int argc, char *argv[]) { QApplication::setHighDpiScaleFactorRoundingPolicy( Qt::HighDpiScaleFactorRoundingPolicy::PassThrough); QApplication app(argc, argv); QWidget w; w.setWindowTitle(QStringLiteral(Qt 5.15.2 on Windows 11)); w.resize(320, 240); w.show(); return app.exec(); }这里setHighDpiScaleFactorRoundingPolicy是 Qt 5.14 之后引入的方法5.15.2 里可以直接用。目的是让分数缩放比例不被强行取整Windows 11 对高 DPI 的默认策略和 Qt 5.15.2 碰撞时这句话经常能解决界面字体发虚的问题。5.2 首次编译容易踩的三类报错第一类是“No suitable kits found”或者“Qt version is not properly installed”这代表 qmake 路径没配对或安装时组件缺失。回到第 4 章把 Kit 重新排查一遍就行。第二类是编译时报找不到Qt5Cored.dll之类的动态库常见原因是运行的是 Debug 构建但模块只勾了 Release 文件。安装时默认一般都会带上 Debug 和 Release 两种符号但要你在组件树里没充分展开时漏掉某些模块的 Debug 版本运行阶段就会崩。打开“项目 → 构建套件”看看是 Debug 还是 Release实在不行重新运行安装器勾上对应模块。第三类常见报错是中文内容变成乱码尤其是源码里直接写中文窗口标题时。MSVC 编译器对源文件编码非常敏感。Qt Creator 里把源码文件编码设为 UTF-8并且建议在 .pro 文件里加上/utf-8编译选项msvc { QMAKE_CXXFLAGS /utf-8 }这条经验是纯实战出的不加的话同一个字符串在 Windows 11 中文环境下经常会编译出乱码字符。5.3 再验证一下发布部署跑通一个空窗口后顺手验证windeployqt是很有价值的。从 Developer PowerShell 进入构建目录执行D:\QtLib\Qt\5.15.2\msvc2019_64\bin\windeployqt.exe 你的程序名.exe它能自动把 Qt 依赖的 DLL 和插件目录拽到 exe 旁边。这一步能让你确认两个信息一是 Qt 实际使用的动态库路径跟你 Kit 配置一致二是用 5.15.2 打的包在另一台裸机 Windows 11 上也能跑起来。很多时候开发机能跑、换台机器就缺 DLL就是因为没做这步。6. 在线安装后维护与升级的实践笔记6.1 增减组件千万别卸载重装Qt 在线安装器的组件管理方式很像软件市场里常见的“安装/管理”模式。你想加个 Qt 5.15.2 的 Qt Charts只需重新运行安装器登录后选择“添加或移除组件”在组件树里把对应模块勾上即可。这个过程只增量下载缺失的文件不用动整个目录非常快。反过来如果哪个组件从没用到也可以直接移除。这里有个小经验移除组件时留意 Qt Creator 的 Kit 引用。如果某个 Kit 用到了被移除的那个 Qt 版本Creator 会报告 Qt 版本失效需要回去删掉旧 Kit 或换个路径。我一度在检视项目时看到一堆报错最后才发现是旧 Kit 还挂着已被移除的 Qt 版本。6.2 在线安装器自身版本和 Qt 版本的关系你下载的在线安装器程序本身也有版本号通常形如qt-online-installer-windows-x64-4.x.x.exe。安装器更新版本不会影响你已装的 Qt 5.15.2但新安装器可能改变组件树的某些分类方式。我遇到过一次安装器升级后模块名从“Qt”大类挪到“Qt Additional Libraries”里当时找了一会儿才找到。保持在线安装器是当前版本有助于你看到完整列表但换版本之前不需要卸载 Qt。6.3 卸载和清理的边界要彻底移除 Qt最干净的入口是重新运行安装器登录后选择“卸载组件”让安装器自己把已装组件逐个干掉。卸载完成后C:\Qt或D:\QtLib\Qt目录里通常还会残留一些日志文件、缓存和空目录手动删掉即可。但**.user 配置文件、Qt Creator 的项目构建缓存**不在 Qt 安装目录里如果你想让一台机器彻底“遗忘” Qt 环境还需要清理%APPDATA%\QtProject和项目目录下的 build 文件夹。这个容易漏导致重装之后编译器自动检测时还残存旧配置。7. 网络与时间成本把这套流程的预期值收好每次提在线安装总会有人问“下载好慢怎么办”“卡在某个文件是不是装错了”。我在第 3.3 节提过先观察、再重试的原则。这里再补充一句在线安装器选择下载哪个服务器的逻辑是自动的一般走官方源。对个人开发者来说唯一现实的做法是选网络条件相对空闲的时间段来装比如早晨或工作日晚间避免下载高峰时段正好撞上一个大模块传输。不要同时开其他大量占网速的上传下载任务也别手滑取消正在跑的任务。给我的整体时间感受是只装 MSVC 2019 64-bit Qt Creator正常宽带环境下十几二十分钟能完成如果贪心把 WebEngine 也勾了那时间会明显拉长所以还是回到第 3.2 节的策略——只装现在需要的。8. 最后分享一点个人实践后的体会从 Windows 10 这台老战友换到 Windows 11 新机器再到后来帮朋友处理同一套流程我最大的感受是Qt 5.15.2 的安装本身并不难难的是把它和 Visual Studio、Windows SDK、调试器这些东西组装成一个能用的“环境”。很多人所谓“装 Qt 失败”其实失败在 Component 勾选的缺失和 Kit 配置的不完整上跟 Qt 本体没什么关系。所以我的建议是装之前把 Visual Studio 装完整注册账号提前搞定安装时克制地勾组件装完先看 Kit 是否检测正常再用一个最小 Widgets 程序跑一遍。这套顺序走通之后你在 Windows 11 上的 Qt 开发环境就是一套非常稳定的底座后续不管是维护旧项目还是用 Qt 5.15.2 做工具软件都不用再回头折腾环境问题。按照我写的步骤来你今晚大概就能看到一个干干净净的 Qt 窗口在你的 Windows 11 桌面上弹出来。