适合人群： 完全没有 Qt 经验的新手
前言
Qt 是一个跨平台的应用开发框架，能让你用一套代码同时构建 Windows、macOS、Linux、Android、iOS 乃至嵌入式设备上的应用程序。在开始写第一行代码之前，第一步就是把 Qt 正确地安装到你的电脑上。
本文对应 Qt Academy 官方课程 How to Install Qt，覆盖从下载安装器到第一次启动 Qt Creator 的完整流程。
一、Qt 的组成：先搞清楚你在装什么
很多新手把"Qt"当成一个单一软件，实际上它由几个独立部分组成：
| 组件 | 是什么 | 类比 |
|---|---|---|
| Qt 框架 | 核心库，包含 QML、Widgets、网络、数据库等模块 | 食材 |
| Qt Creator | 官方 IDE（集成开发环境），写代码用的编辑器 | 厨具 |
| Qt Maintenance Tool | 安装完成后用于管理、更新、添加模块的工具 | 采购清单 |
| Qt Online Installer | 安装向导，负责把以上一切下载并安装到你电脑上 | 快递员 |
关键点： 你只需要下载一个 Qt Online Installer，它会帮你把其余所有东西装好。
二、下载 Qt Online Installer
2.1 访问官网
前往 Qt 官方下载页面：
https://www.qt.io/download-dev
- 如果你是个人学习或开源项目，选择 "Download open source" （免费）
- 如果是商业用途，选择商业版本
2.2 注册 Qt 账号
Qt Online Installer 需要一个 Qt 账号才能运行。如果你还没有：
- 前往 login.qt.io 注册
- 验证邮箱
- 记好用户名和密码，安装时需要登录
为什么需要账号？
Qt 通过账号管理许可证。即使是免费的开源版本，也需要账号来确认你接受了 LGPL/GPL 授权协议。
三、运行安装器
下载完成后，运行安装器文件（Windows 是 .exe，macOS 是 .dmg，Linux 是 .run）。
3.1 登录账号
启动后第一步是登录你的 Qt 账号，输入邮箱和密码即可。
3.2 选择安装类型
安装器会询问你想要"自定义安装"还是"推荐安装"。
推荐新手选择"自定义安装" ，原因：
- 推荐安装会下载大量你暂时用不到的组件
- 自定义安装让你清楚地知道自己装了什么
- 后续可以通过 Qt Maintenance Tool 随时补充
3.3 选择组件
这是最关键的一步。安装器会展示一棵组件树，你需要勾选需要的内容。
新手推荐最小安装组合：
Qt
└── Qt 6.x.x（选择最新稳定版）
├── Desktop（根据你的系统选择）
│ ├── MSVC 2022 64-bit（Windows，需要安装 Visual Studio）
│ ├── MinGW 64-bit（Windows，更简单，推荐新手）
│ └── macOS（Mac 用户选这个）
└── Qt Creator x.x.x（必选）
Developer and Designer Tools
└── Qt Creator x.x.x（IDE 本体，必选）
暂时不需要勾选的（等需要时再加）：
- Android / iOS 相关工具链（需要额外配置）
- Qt for WebAssembly
- Qt Charts、Qt 3D 等扩展模块
3.4 接受许可协议并安装
确认安装路径（建议使用默认路径，避免中文路径导致问题），点击"安装"，等待下载完成。
下载时间取决于网速，通常需要 10～30 分钟。
四、安装完成后：认识 Qt Maintenance Tool
安装完成后，你的开始菜单（Windows）或应用文件夹（macOS）里会出现两个重要程序：
Qt Creator
用于日常开发的 IDE，接下来大部分时间都在这里度过。
Qt Maintenance Tool
安装完成后千万不要删它。 它的用途：
- 添加新模块：比如之后学嵌入式开发时，需要添加 Qt for MCUs
- 升级 Qt 版本：当新版本发布时，通过它升级
- 卸载特定组件：释放磁盘空间
- 完全卸载 Qt：干净地移除所有内容
可以把它理解成 Qt 的"控制面板"，是长期使用 Qt 必不可少的工具。
五、启动 Qt Creator，验证安装成功
打开 Qt Creator，你应该看到欢迎界面。
5.1 验证编译器配置
点击菜单 Edit → Preferences（macOS 是 Qt Creator → Settings）→ Kits
如果看到一个绿色对勾的 Kit（如 "Desktop Qt 6.x.x MinGW"），说明安装成功，编译器已自动识别。
如果显示黄色感叹号，通常是编译器路径未找到，需要手动指定。
5.2 创建第一个测试项目
- 点击 "New Project"
- 选择 Qt Quick Application
- 一路 Next，使用默认设置
- 点击左下角绿色三角形 Run
如果看到一个空白窗口弹出来——恭喜，Qt 安装成功！
六、常见问题
Q：安装时网速很慢怎么办？
可以尝试在安装器的"设置"里切换镜像源。国内用户推荐使用：
https://mirrors.tuna.tsinghua.edu.cn/qt/
Q：Windows 上应该选 MSVC 还是 MinGW？
- MinGW：开箱即用，不需要安装 Visual Studio，推荐新手
- MSVC：需要先安装 Visual Studio（免费社区版即可），性能更好，企业项目更常用
Q：安装路径可以改吗？
可以，但注意：路径中不能有中文、空格或特殊字符，否则编译时可能报错。
Q：Qt 安装包有多大？
最小安装（一个桌面平台 + Qt Creator）约 2～3 GB。如果全部勾选可能超过 20 GB，所以自定义安装很有必要。
七、下一步
安装完成后，建议按以下顺序继续学习：
- 认识 Qt Creator 界面 — 了解编辑器、项目视图、构建输出各区域的用途
- Building with CMake — 理解 Qt 项目是如何被构建的
- Introduction to QML — 开始写第一段真正的 Qt 代码
总结
| 步骤 | 关键点 |
|---|---|
| 下载 | 使用 Qt Online Installer，注册免费账号 |
| 安装 | 自定义安装，只勾选当前需要的组件 |
| 工具 | Qt Creator 是 IDE，Qt Maintenance Tool 是长期维护工具 |
| 验证 | 创建一个 Qt Quick 项目并成功运行 |
