Windows 下 Qt 安装包下载与安装全攻略

对于想要在 Windows 系统上进行跨平台应用开发的朋友来说，Qt 是一个强大且流行的选择。但面对官网众多的安装包选项，新手很容易感到困惑。本文将手把手教你如何选择、下载并安装最适合你的 Qt 版本，让你快速搭建起开发环境。

一、 Qt 是什么？为什么选择它？

简单来说，Qt 是一套用于开发图形用户界面（GUI）和非 GUI 程序的 C++ 跨平台框架。你用它写的程序，只需少量修改甚至无需修改，就能在 Windows、MACOS、Linux、甚至安卓和 iOS 上运行。许多知名软件，如 WPS Office、VirtualBox、Autodesk Maya 等，都是用 Qt 开发的。

对于初学者和开发者，选择 Qt 主要因为它：

1. 跨平台：一次编写，多处编译运行。
2. 功能强大：不仅限于界面，还包含网络、数据库、多媒体等丰富模块。
3. 开发高效：提供可视化的设计工具 Qt Designer，能拖拽组件搭建界面。
4. 许可灵活：提供开源（免费）和商业两种授权方式。

二、 下载前的准备工作：明确你的需求

在打开下载页面之前，先问自己三个问题，这能帮你避免下载错误或臃肿的安装包：

1. 用于商业开发还是个人学习？

   • 个人学习/开源项目：选择 开源版本。这是完全免费的。
   • 开发闭源的商业软件：需要购买 商业许可证，或者确保你的代码符合开源协议（如 LGPL v3）。

2. 主要使用什么编程语言？

   • C++：这是 Qt 的原生语言，支持最全面。
   • Python：非常流行，需要下载 Qt 库的同时，安装 PySide2/PySide6 或 PyQt5/PyQt6 绑定库。本文主要聚焦 C++ 安装。

3. 需要哪些 Qt 模块和功能？

   • 基础界面开发：核心的 GUI 模块就足够了。
   • 需要图表、数据可视化：可能需要 Qt Charts 模块。
   • 需要连接数据库：需要 Qt SQL 模块及对应的数据库驱动。
   • 不确定，想先都试试：初次安装可以选择默认组件，或全选（但安装包会很大）。

三、 一步步下载 Qt 安装包

重要提示：Qt 官方推荐使用在线安装器，因为它能让你自由选择需要的版本和组件，管理起来也方便。我们强烈推荐这种方式。

步骤 1：获取 Qt 在线安装器

1. 打开你的浏览器，访问 Qt 官方网站的下载页面。你可以通过搜索“Qt download”找到它，或者直接访问其官方的下载区域。
2. 在下载页面，找到 “Download the Qt Online Installer” 部分。你会看到两个主要的安装器：
   • Windows 版：通常是一个名为 qt-unified-windows-x86-64-x.x.x-online.exe 的文件（x.x.x是版本号）。
   • macOS/Linux 版：根据你的系统选择。
3. 点击 Windows 版 的下载链接。文件大小约几十MB。

步骤 2：运行在线安装器并登录/注册

1. 找到下载好的 .exe 文件，双击运行。
2. 安装器启动后，首先会提示你登录 Qt 账户。
   • 如果你有账户：直接输入邮箱和密码登录。
   • 如果你没有账户：点击下方的 “Sign Up” 链接进行注册。注册是免费的，只需提供邮箱、设置密码等信息。即使使用开源版本，也需要一个账户来使用在线安装器。
3. 登录成功后，进入安装流程。

步骤 3：选择安装路径和组件（最关键的一步）

1. 设置安装路径：建议不要安装在C盘根目录或带有中文、空格的路径下。例如，可以设为 D:\Qt。
2. 选择安装组件：这是核心步骤，界面是一个树状复选框列表。
   • Qt 版本：展开 “Qt” -> 你会看到多个版本，例如 Qt 6.5.3, Qt 5.15.2 等。
     • 新手建议：选择最新的 稳定版本，如 Qt 6.5.x 系列。勾选它前面的主复选框。
     • 展开该版本，你会看到子组件：
       • MSVC 2019 64-bit：推荐大多数 Windows 用户选择。这是用于 Visual Studio 2019 编译器的 64 位版本。即使你暂时不用VS，也建议安装，因为Qt Creator默认会用它。
       • MinGW 11.2.0 64-bit：这是使用 MinGW-GCC 编译器的版本。如果你不想安装庞大的 Visual Studio，可以选择这个。注意：MinGW 和 MSVC 的组件不通用，通常二选一即可。
       • Sources：Qt 的源代码，除非你需要调试进 Qt 内部或阅读源码，否则不用勾选。
       • Debugging Tools：调试工具，建议勾选。
   • 开发者工具：务必勾选 Qt Creator x.x.x。这是 Qt 官方的集成开发环境（IDE），写代码、设计界面、编译调试都在这里面完成，对新手极其友好。
   • 其他工具：MinGW 编译器（如果你上面选了MinGW组件，这里会自动关联）、CMake 等，安装器会根据你的选择自动勾选依赖项，一般保持默认即可。

给新手的组件选择建议：

• 只想快速上手：勾选 Qt Creator + Qt 6.5.x 下的 MSVC 2019 64-bit（或 MinGW 64-bit）。
• 硬盘空间充足（>20GB）：可以把 Qt 6.5.x 下的 MSVC 和 MinGW 都勾上，多个编译器备用。

3. 选择好后，点击 “下一步”，接受许可协议，然后开始安装。安装时间取决于你的网速和选择的组件数量，可能需要半小时到数小时。

四、 安装后的验证与第一个程序

1. 启动 Qt Creator：安装完成后，在开始菜单找到 Qt 文件夹，运行 Qt Creator。
2. 创建测试项目：
   • 点击 File -> New File or Project...。
   • 选择 Application -> Qt Widgets Application，点击 Choose...。
   • 给项目起个名字，如 HelloQt，选择好保存路径。
   • 在 Kit Selection 页面，你会看到之前安装的编译套件（如 Desktop Qt 6.5.3 MSVC2019 64bit），勾选它。
   • 一路点击 Next，最后点击 Finish。
3. 编译运行：
   • 在 Qt Creator 左下角，点击绿色的“运行”三角按钮（或按 Ctrl+R）。
   • 如果一切顺利，你将看到一个空白的窗口弹出来。恭喜你，Qt 开发环境已经成功搭建！

五、 常见问题与避坑指南

• 安装时下载速度慢/失败：

  • 使用镜像源：在运行在线安装器时，在登录后的主界面，点击右下角的“Settings”，在“Repository”选项卡中，替换默认的官方仓库地址为国内镜像地址（例如中国科技大学的镜像），可以极大提升下载速度。
  • 检查网络和代理：确保网络连接稳定，如果使用了代理软件，可能需要配置安装器使用代理或暂时关闭。

• *运行程序提示缺少 `.dll` 文件**：

  • 这是因为程序依赖的动态库没有找到。在开发时，用 Qt Creator 直接运行不会出错。如果你将编译好的 .exe 文件复制到别的电脑上运行，需要将对应的 Qt DLL 文件一起打包。可以使用 windeployqt 工具（在 Qt 安装目录的 bin 文件夹里）自动处理依赖。

• 如何选择 Qt 5 还是 Qt 6？

  • Qt 6 是未来，它包含了许多现代化改进和新模块。对于新项目，无脑选 Qt 6。
  • Qt 5.15 是 Qt 5 的最后一个版本，只有商业版或开源用户自己编译才能获得官方漏洞修复。除非维护遗留的老项目，否则不建议新学者专门安装 Qt 5。

• 需要安装 Visual Studio 吗？

  • 如果你选择了 MSVC 组件，需要安装对应的 Visual Studio（如 2019/2022），并且安装时至少要勾选“使用C++的桌面开发”工作负载。
  • 如果你选择了 MinGW 组件，则不需要安装 Visual Studio，Qt 安装包自带了 MinGW 编译器。

现在，你已经成功在 Windows 上安装了 Qt，并运行了第一个窗口程序。接下来，就可以尽情探索 Qt 的强大功能，开始你的跨平台开发之旅了。遇到具体编程问题，多查阅 Qt 官方文档和活跃的社区论坛，成长会更快。