Qt 6 下载与安装：新手入门必看指南 – wiki基地

作者： /

Qt 6 下载与安装：新手入门必看终极指南

引言：为什么选择 Qt？

欢迎来到 Qt 的世界！Qt 是一个功能强大、成熟稳定且享誉全球的跨平台 C++ 应用程序开发框架。无论您是想开发精美的桌面软件、高性能的嵌入式系统，还是流畅的移动应用，Qt 都能为您提供一站式的解决方案。它以其卓越的图形界面（GUI）库、丰富的类库、直观的开发工具（如 Qt Creator IDE）以及“一次编写，随处编译”的跨平台能力，吸引了从个人开发者、学生到大型企业的无数拥趸。

对于新手而言，强大的功能背后往往伴随着复杂的初次配置。本指南的目的就是扫清这第一道障碍。我们将手把手地带您走过从环境准备、账户注册、下载安装，到最终验证成功的全过程。请跟随我们的脚步，耐心细致地完成每一步，您会发现，配置 Qt 并没有想象中那么困难。

第一章：万事开头难？不，是准备工作

在正式下载 Qt 之前，我们需要确保我们的开发环境已经“万事俱备”。这一步至关重要，能避免后续安装过程中 90% 的常见问题。

1.1 系统要求评估

首先，检查您的计算机是否满足 Qt 6 的基本要求：

  • 操作系统:
    • Windows: Windows 10 或 Windows 11 (64-bit)。
    • macOS: macOS 11 (Big Sur) 或更高版本。
    • Linux: 主流的 64 位发行版，如 Ubuntu 20.04 LTS, CentOS 8.2 等。
  • 硬盘空间: Qt 是一个庞大的框架。一个包含常用模块和开发工具的完整安装至少需要 10-15 GB 的可用空间。为了后续项目开发和缓存，我们强烈建议您预留 30 GB 以上的空闲磁盘空间。
  • 内存 (RAM): 建议至少 8 GB，16 GB 或以上更佳，尤其是在编译大型项目时。

1.2 核心前提：安装 C++ 编译器

这是新手最容易忽略，也是最关键的一步！Qt 本身只是一个 C++ 类库，它不包含 C++ 编译器。 您必须先在系统中安装一个 C++ 编译器，Qt Creator 才能调用它来编译您的代码。

  • 对于 Windows 用户：

    • 推荐方案：MinGW-w64。MinGW (Minimalist GNU for Windows) 是一个开源的 Windows 版 GCC 编译器套件。好消息是，Qt 的在线安装程序可以自动为您下载和配置 MinGW，因此您无需手动安装。在后续安装步骤中，我们只需要勾选正确的 MinGW 组件即可。这是对新手最友好的方式。
    • 备选方案：MSVC (Microsoft Visual C++)。这是由微软 Visual Studio 提供的编译器。如果您已经安装了 Visual Studio (2019 或更高版本)，并在安装时勾选了“使用 C++ 的桌面开发”工作负载，那么您的系统中就已经有了 MSVC 编译器。在安装 Qt 时，您可以选择与之对应的 MSVC 版本。

    新手建议： 如果您没有特殊需求，也未安装 Visual Studio，请直接采用第一种方案，在 Qt 安装过程中选择由它提供的 MinGW 编译器。

  • 对于 macOS 用户：

    • 您需要安装 Xcode。直接从 Mac App Store 搜索并安装 Xcode 即可。安装完成后，务必打开终端（Terminal）并运行以下命令来安装命令行工具，其中包含了 Clang 编译器：
      bash
      xcode-select --install

  • 对于 Linux 用户 (以 Ubuntu/Debian 为例)：

    • 您需要安装 build-essential 包，它包含了 GCC/G++ 编译器和其它必要的编译工具。打开终端并运行：
      bash
      sudo apt-get update
      sudo apt-get install build-essential

1.3 注册一个 Qt 账户

从 Qt 5.15 版本开始，使用官方在线安装程序必须登录 Qt 账户。这是一个免费且简单的过程。

  1. 访问 Qt 官方账户注册页面：https://login.qt.io/register
  2. 使用您的邮箱进行注册，并设置密码。
  3. 您会收到一封验证邮件，点击邮件中的链接以激活您的账户。
  4. 请牢记您的邮箱和密码，因为在安装过程中需要用到。

第二章：下载 Qt 在线安装程序

准备工作就绪，现在我们可以正式下载 Qt 了。我们强烈推荐使用在线安装程序 (Online Installer)，因为它体积小，且允许您按需选择需要安装的组件，方便后续添加或删除模块。

  1. 访问官网: 打开 Qt 官方网站 www.qt.io。
  2. 找到下载页面: 通常在首页会有一个明显的 “Download. Try.” 或类似的按钮。点击它。
  3. 选择开源版本: Qt 提供商业版和开源版。对于学习、个人项目或符合开源许可（LGPLv3）的项目，选择开源版本即可。您可能会看到一个引导您购买商业版的页面，请仔细寻找指向“Get your open source package”或类似文本的链接。
  4. 下载安装程序: 在开源下载页面，找到 “Download the Qt Online Installer” 按钮。网站会自动检测您的操作系统（Windows, macOS, Linux），并提供相应的下载链接。点击下载。

您将得到一个几MB到几十MB大小的安装文件，例如 qt-unified-windows-x64-online.exe (Windows版)。

第三章：保姆级安装步骤详解

这是本文的核心部分。我们将逐一解析安装过程中的每一个界面，告诉您每个选项的含义以及如何选择。

步骤 1：运行安装程序
双击您刚刚下载的在线安装程序。程序会进行一些初始化。

步骤 2：登录 Qt 账户
第一个正式界面会要求您输入之前注册的 Qt 账户邮箱和密码。正确输入后点击“下一步”。

步骤 3：开源使用义务
此页面会简要说明您作为开源用户需要遵守的义务（主要是基于 LGPLv3 许可）。请仔细阅读，然后勾选“我已阅读并同意…”，点击“下一步”。

步骤 4：欢迎界面与贡献
这是一个欢迎页面。
* 在底部，您可能会看到一个关于“为 Qt Creator 匿名发送伪数据”的复选框。这是 Qt 的用户体验改善计划，是否勾选取决于您个人意愿，不影响安装。
* 点击“下一步”。

步骤 5：安装文件夹
这里需要您选择 Qt 的安装路径。
* 强烈建议:
* 选择一个简短且不包含中文、空格或特殊字符的路径。例如 C:\Qt 或 D:\Qt。复杂的路径可能会在未来导致一些意想不到的编译问题。
* 确保该分区有足够的空间（至少 30 GB）。
* 选择好路径后，点击“下一步”。

步骤 6：选择安装类型
您会看到“标准安装”和“自定义安装”等选项。请务必选择 “自定义安装 (Custom installation)”，这样我们才能精确控制需要安装的内容。点击“下一步”。

步骤 7：核心环节 – 选择组件 (Select Components)
这是整个安装过程中最重要、也最容易出错的一步。您会看到一个树状列表，罗列了所有可安装的组件。

  • Archive (存档): 这里存放了旧版本的 Qt。通常我们不需要勾选这里面的任何内容，除非您有特殊需求要使用某个非常旧的版本。

  • Qt [版本号] (例如 Qt 6.7.0): 这是您要安装的主要 Qt 版本。请展开最新的稳定版（LTS 版本更佳，如果有时）。

    • MinGW [版本号] 64-bit: (Windows 用户必选) 这就是我们之前提到的编译器！勾选它，安装程序就会自动下载和配置好 MinGW 编译器。这是最省心的方式。
    • MSVC 2019 64-bit: (Windows 用户可选) 如果您系统里安装了 Visual Studio 2019/2022，并且想用 MSVC 编译器，就勾选这个。
    • macOS: (macOS 用户必选) 勾选此项，以安装适配 macOS (Clang 编译器) 的 Qt 库。
    • Linux: (Linux 用户必选) 勾选此项，以安装适配 Linux (GCC 编译器) 的 Qt 库。
    • Additional Libraries (附加库): 默认情况下，一些核心模块会被自动选中。您可以根据需要勾选其他模块，例如：
      • Qt 5 Compatibility Module: 如果您可能要运行一些旧的 Qt 5 项目，可以勾选。
      • Qt WebEngine: 用于在应用中嵌入一个完整的 Chromium 浏览器内核。功能强大但体积巨大（会增加几个 GB 的下载量）。新手可以暂时不选。
      • Qt Charts: 用于绘制图表。
      • 新手建议: 初次安装，只保留默认勾选的模块和您选择的编译器（如 MinGW）即可。以后需要其他模块，可以随时通过维护工具添加。

  • Developer and Designer Tools (开发者和设计者工具): 这一项必须展开并仔细检查！

    • Qt Creator [版本号]: (必选) 这是 Qt 的官方集成开发环境 (IDE)。我们编写、编译、调试代码都在这里进行。请务必勾选它。
    • Qt Creator CDB Debugger Support: (Windows 用户) 如果您选择了 MSVC 编译器，就需要这个调试器支持。
    • Debugging Tools for Windows: (Windows 用户) 强烈建议勾选。它会为您安装 GDB 调试器，这是 MinGW 编译器对应的调试工具。没有它，您的程序将无法进行断点调试。
    • CMake: 一个流行的跨平台构建系统。Qt Creator 支持 CMake。建议勾选。
    • Ninja: 一个高性能的构建工具，通常与 CMake 配合使用。建议勾选。

总结一下新手在 Windows 上的最小化推荐选择：
1. 展开 Qt 6.x.x -> 勾选 MinGW x.x.x 64-bit。
2. 展开 Developer and Designer Tools -> 勾选 Qt Creator x.x.x 和 Debugging Tools for Windows。
3. (可选但推荐) 在 Developer and Designer Tools 下也勾选 CMake 和 Ninja。

步骤 8：许可协议
您需要同意 Qt 的许可协议。勾选“我已阅读并同意许可协议”，点击“下一步”。

步骤 9：开始菜单快捷方式
为 Qt Creator 等工具创建开始菜单快捷方式。保持默认即可，点击“下一步”。

步骤 10：准备安装
安装程序会最后一次列出您选择的组件和所需的空间。确认无误后，点击“安装”。

步骤 11：下载与安装
现在进入漫长的等待时间。安装程序会从服务器下载您选择的所有组件，然后进行安装。这个过程受您的网络速度和计算机性能影响，可能需要几十分钟甚至数小时。请确保网络连接稳定，并耐心等待。

步骤 12：安装完成
当您看到“安装已成功完成”的提示时，恭喜您！点击“完成”即可退出安装程序。您可以选择立即启动 Qt Creator。

第四章：安装后配置与“Hello, World!”验证

安装完成并不意味着大功告成。我们需要进行最后的检查和配置，并创建第一个项目来验证所有设置是否正确。

4.1 首次启动 Qt Creator

从开始菜单或桌面快捷方式启动 Qt Creator。您会看到一个简洁的欢迎界面。

4.2 关键验证：检查构建套件 (Kits)

“构建套件 (Kit)”是 Qt Creator 中的一个核心概念，它捆绑了 Qt 版本、C++ 编译器和调试器。一个正确的 Kit 是成功编译项目的前提。

  1. 在 Qt Creator 菜单栏，选择 工具 (Tools) > 选项 (Options…)。
  2. 在弹出的对话框左侧，选择 构建套件 (Kits)。
  3. 在右侧的 “Kits” 标签页下，您应该能看到一个或多个自动检测到的 Kit。
    • 例如，如果您在安装时选择了 MinGW，您应该会看到一个名为 “Desktop (Qt 6.x.x MinGW 64-bit)” 的 Kit。
    • 关键点: 检查这个 Kit 前面是否有一个绿色的对勾。如果是一个红色的感叹号或黄色的警告三角，说明配置有问题。
    • 正常情况: 安装程序会自动配置好一切。您应该会看到 Kit 的“编译器”和“调试器”都已正确设置为您安装的 MinGW/GDB 或 MSVC/CDB。
    • 如果出现问题: 最常见的原因是编译器未被正确检测到。请切换到“编译器”和“调试器”标签页，检查路径是否正确指向您安装的位置（例如 C:\Qt\Tools\mingw...\bin\g++.exe）。

4.3 创建你的第一个项目：“Hello, World!”

现在，让我们通过创建一个最简单的窗口程序来检验成果。

  1. 在 Qt Creator 欢迎界面，点击 + 新建项目 (New Project)，或者通过菜单栏 文件 (File) > 新建文件或项目 (New File or Project…)。
  2. 在弹出的窗口中，选择 Application (Qt) > Qt Widgets Application，然后点击“选择 (Choose…)”。
  3. 项目名称和位置:
    • 为您的项目起一个名字，例如 HelloWorld。
    • 选择一个保存项目的路径（建议不要放在 Qt 安装目录内）。
    • 点击“下一步”。
  4. 构建系统: 您可以选择 qmake 或 CMake。对于初学者，qmake 更简单直观。选择 qmake，点击“下一步”。
  5. 类信息: 这里定义了主窗口的类名等信息。保持默认的 QMainWindow 即可，点击“下一步”。
  6. 翻译文件: 暂时不需要，直接点击“下一步”。
  7. 选择构建套件 (Kit): 这是关键一步！勾选我们之前验证过的那个带有绿色对勾的 Kit，例如 “Desktop (Qt 6.x.x MinGW 64-bit)”。点击“下一步”。
  8. 项目管理: 可以选择添加到版本控制系统，直接点击“完成 (Finish)”。

现在，Qt Creator 会为您生成一个项目的基本框架，包含 .pro (项目管理文件)、main.cpp (主函数入口)、mainwindow.h (头文件)、mainwindow.cpp (源文件) 和 mainwindow.ui (UI 设计文件)。

4.4 编译并运行

  1. 在 Qt Creator 界面的左下角，找到一个绿色的三角形“运行”按钮。
  2. 确保其旁边的构建配置是 “Debug”。
  3. 点击这个绿色的运行按钮！

Qt Creator 会首先编译您的项目（底部“编译输出”窗口会显示进度），然后运行生成的可执行文件。如果一切顺利，几秒钟后，一个空白的、带有标准窗口边框的小窗口将出现在您的屏幕上。

如果您看到了这个窗口，那么热烈祝贺您！您已经成功完成了 Qt 6 的安装与配置，并创建了您的第一个 Qt 应用程序！

第五章：常见问题 (FAQ) 与后续学习

  • Q: 安装后发现 Kit 有红色感叹号怎么办？
    A: 99% 的可能是编译器或调试器路径问题。回到“选项 > 构建套件”，手动指定正确的编译器 (g++.exe/cl.exe) 和调试器 (gdb.exe/cdb.exe) 的路径。

  • Q: 我想添加一个之前没安装的模块（比如 Qt Charts）怎么办？
    A: 无需重新安装。在您的 Qt 安装目录（例如 C:\Qt）下，找到 MaintenanceTool.exe。运行它，登录您的 Qt 账户，然后选择“添加或删除组件”，就可以像初次安装时一样勾选您需要的模块了。

  • Q: 安装太大了，如何减小体积？
    A: 在选择组件时，只勾选您确定需要的一个编译器套件（如 MinGW 64-bit），不要勾选其它编译器。同时，暂时不要安装像 Qt WebEngine 这样的大型附加库。

  • Q: 接下来我该学什么？
    A:

    1. 探索 Qt Creator: 熟悉 UI 设计器（双击 mainwindow.ui 文件）、代码编辑器和调试功能。
    2. 学习信号与槽: 这是 Qt 的核心机制，用于对象间的通信。
    3. 浏览官方文档和示例: Qt Creator 的“欢迎”页面就有丰富的示例项目。这是最好的学习资源。
    4. 尝试简单的控件: 尝试向窗口中添加按钮、文本框等控件，并用信号与槽实现简单的交互。

总结

安装 Qt 6 的过程虽然步骤繁多，但只要我们遵循正确的顺序——准备编译器环境、注册账户、使用在线安装程序、细心选择组件、验证构建套件——就能顺利完成。本指南力求详尽，希望能为您扫清初学路上的第一个障碍。

编程之旅，始于环境搭建。现在，您已经拥有了一个强大的工具，广阔的创意天地正等待您去探索。祝您在 Qt 的世界里编程愉快！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部