作者： 一去、二三里
个人微信号： iwaleon
微信公众号： 高效程序员
为了开始使用 Qt 进行开发，需要搭建一个合适的开发环境。由于我们的教程 《细说 QML》 是基于 Qt6 的，而截至目前为止，Qt6 的最新版本为 Qt6.5，所以我们就以该版本为例，详细介绍下 Windows 下的开发环境搭建。
安装参考
Qt 的安装方式有多种，可以选择在线安装或者离线安装，也可以自己编译源码。官方建议我们选择在线安装，这样做的好处是便于后续更换版本（通过 Qt Maintenance Tool 工具）。
对于在线安装器（Online Installer）来说，它本身其实是一个下载安装程序，并不附带 Qt 的组件和模块。当我们登录帐户之后，它会从服务器获取该帐户关联的许可证，并根据许可证列出对应的组件和模块。一旦我们选择好之后，它便会从服务器上实时下载并进行安装，这样可以确保获取的组件和模块始终是最新的并且适用于当前平台。
而离线安装器（Offline Installer）是一个较大的压缩包，包含了与当前平台相关的所有 Qt 模块和组件（大小通常比在线安装器大得多），可以在无网环境中进行安装。但由于官方策略的改变，从 Qt 5.15 开始，就不再提供离线安装器了。
Due to The Qt Company offering changes, open source offline installers are not available any more since Qt 5.15.
更多详见：Qt offering changes 2020
也就是说，要想使用离线安装器，要么选择 5.15 之前的版本，要么成为商业用户。
有关 Qt 的下载地址，可以参考以下链接：
- Qt 下载地址：https://download.qt.io/
- 在线安装器：https://download.qt.io/archive/online_installers/
- 离线安装器：https://www.qt.io/offline-installers
另外，也建议了解一下 Qt 的一些关键知识：
- Qt 版本历史：https://en.wikipedia.org/wiki/Qt_version_history
- Qt 模块：https://doc.qt.io/qt.html
- Qt 许可：https://www.qt.io/licensing/
重要提示： Qt 提供了两种许可协议 - 开源协议和商业协议，如果是个人学习（不用作商业途径），没有太大影响；但如果在公司内使用，最好和部门经理、法务团队沟通一下，以确保遵循协议不出现违规情况。
下载安装器
打开 在线安装器，选择 4.6 安装包并进行下载：
配置镜像源
如果直接使用在线安装器安装 Qt，速度通常会很慢，因为默认连接的是国外的 Qt 服务器，而我们在国内，网络延迟较高，导致下载速度变慢。
为了加速 Qt 在线安装器的下载，建议配置使用国内的镜像源，例如：
- 阿里云开源镜像站：https://mirrors.aliyun.com/qt/
- 清华大学开源镜像站：https://mirrors.tuna.tsinghua.edu.cn/qt/
- 上海交大开源镜像站：https://mirrors.sjtug.sjtu.edu.cn/qt/
只需打开 Powershell，执行以下命令即可：
.\qt-unified-windows-x64-4.6.0-online.exe --mirror https://mirrors.tuna.tsinghua.edu.cn/qt/
或者打开 Qt 在线安装器，在设置中配置一下 Repository 储存库（Name 和 URL）。
通过这种方式，在线安装器将会从配置的镜像源下载所需的组件，让速度起飞。
在线安装
运行下载好的 Qt 在线安装器，按照安装向导的提示进行安装。
- 登录
登录 Qt 账户，倘若没有，点击界面上的“注册”进行创建。
- 开源义务
如果是个人使用，勾选最底下的复选框；如果是公司，需要填写公司名称。
建议认真阅读这里的协议，并在后续使用中遵循，否则很容易收到律师函。
- 欢迎
欢迎使用 Qt，直接点击“下一步”。
- 为 Qt 做贡献
第一个是“发送统计信息帮助 Qt 改进”，第二个是“禁止发送”。
我选择的是禁止，因为不清楚到底在统计什么？是使用了哪些商业模块？还是收集了什么敏感信息？还是 …
- 安装目录
按照个人习惯选择安装路径（不能包含中文、空格等特殊字符），并选择“自定义安装”。
- 选择组件
这些组件分为两部分：一部分位于“Qt 6.5.2”下，主要包含了 Qt 的开发库以及源码；另一部分位于“Developer and Designer Tools”下，主要包含了 IDE（Qt Creator）以及其它一些工具，有助于我们提升开发效率。
| 组件 | 描述 |
|---|---|
| WebAssembly | 用于在浏览器中运行应用程序的二进制格式，如果希望使用 Qt 开发 Web 应用，特别是使用 WebAssembly 进行部署，建议勾选。 |
| MSVC 2019 64-bit | 适用于 MSVC（全称：Microsoft Visual C++）编译器的 Qt 开发库，如果想用 MSVC 构建和运行 Qt 程序，建议勾选。 |
| MinGW 11.2.0 64-bit | 适用于 MinGW（全称：Minimalist GNU for Windows）编译器的 Qt 开发库，如果想用 MinGW 构建和运行 Qt 程序，建议勾选。 |
| Android | 针对安卓开发的 Qt 库，如果有要适配安卓，建议勾选。 |
| Sources | Qt 源码，如果想研究源码，建议勾选。 |
| Additional Libraries | 一些附加模块，大部分建议安装（占用空间不大）。其中，模块后括号里的 Technology Preview 表示技术预览，说明该模块仍在开发中（非正式版模块）；而 Deprecated 是指被遗弃的旧模块（兼容旧代码使用的），一般用不到。 |
| Qt Creator 11.0.2 | IDE，后续就靠它写代码了，必选。 |
| CMake | 非常流行的开源跨平台构建工具，设计理念与 QMake 相似，但在实现和用法上有一些区别。由于 Qt6 的工具链已经逐步从 QMake 迁移到了 CMake，因此建议勾选。 |
- 许可协议
必须接受才能继续安装，所以有什么好说的呢？勾选“同意”就对了。
- 开始菜单快捷方式
默认即可，直接点击“下一步”。
- 准备安装
这里会提示我们安装时将占用的磁盘空间，如果磁盘大小不够，可以点击“上一步”进行调整。
- 正在安装
开始进行安装了，稍等片刻。
- 已完成
到这里就安装完成了，点击“完成”退出 Qt 向导。
环境测试
为了测试 Qt 环境是否搭建成功，可以创建一个简单的应用程序，并编译运行它。
打开 Qt Creator，进入“欢迎”模式，点击“创建项目”（或者在“文件”菜单中选择“创建项目”）。在弹出的对话框中选择“Qt Quick Application”，然后按照向导完成新项目的创建。
在新项目创建完成后，会生成一段简单的示例代码：
import QtQuick
import QtQuick.Window
Window {
width: 640
height: 480
visible: true
title: qsTr("Hello World")
}
点击工具栏上的“Run”按钮（或者使用快捷键“Ctrl + R”），即可编译并运行该应用程序，效果如下：
恭喜，这就说明 Qt6 开发环境搭建成功了，让我们一起正式进入开发之旅吧。
小彩蛋：
看完文章之后，你发现了什么？
- Qt5.15 开始不再提供离线安装器（从此强化商业协议）
- 需要账号才能登录（收集用户信息）
- 勾选、安装组件（记录安装行为，组件的使用情况）
- 发送统计信息帮助 Qt 改进（统计使用了哪些组件？）
- 着重强调开源协议（要么做贡献，要么付费）
- …
这下明白为什么要在线安装了吧？可以更好地收集个人信息（账号、公司、组件使用情况），以此来分析你是否违反许可协议。
所以说，遵循协议很关键，不遵循就会收到律师函。当然即使遵循了也很有可能收到，不信你问问周围的小伙伴 O(∩_∩)O哈哈~。