手把手教你安装 Qt (快速入门) – wiki基地

---

手把手教你安装 Qt：从零开始的快速入门指南 (详细版)

欢迎来到跨平台应用开发的世界！如果你对图形界面（GUI）编程充满兴趣，或者想开发能够同时在 Windows、macOS、Linux、甚至移动设备上运行的应用程序，那么 Qt 绝对是你不可错过的强大工具箱。

Qt 不仅仅是一个 GUI 库，它是一整套成熟的开发框架，提供了丰富的模块和工具，涵盖了 UI 设计、网络、数据库、多媒体、并发、硬件访问等方方面面。基于 C++ 语言，Qt 以其高性能、灵活性和“一次编写，处处运行”的特性赢得了全球开发者的青睐。

对于初学者来说，安装 Qt 可能是迈出的第一步，有时会遇到一些困惑。别担心！本篇文章将以“手把手”的方式，一步一个脚印地引导你完成 Qt 的安装过程，即使你之前没有任何经验，也能顺利搭建好你的开发环境。

我们将详细讲解每个步骤，包括下载、运行安装程序、选择组件、配置环境等，并会针对不同的操作系统（Windows、macOS、Linux）提供相应的提示。让我们开始吧！

第一部分：安装前的准备工作

在正式下载和安装 Qt 之前，我们需要做一些简单的准备，确保你的系统符合要求，并且了解你需要下载什么。

1. 检查系统要求

Qt 支持多种操作系统，但在安装之前，最好确认你的系统满足基本的硬件和软件要求。通常来说，只要你的操作系统不是过于老旧（例如 Windows 7 SP1 或更新，macOS 10.14 或更新，主流的 Linux 发行版），并且有足够的硬盘空间和内存，就可以顺利安装和运行 Qt。

• 硬盘空间： Qt 及其相关的工具和组件会占用不少硬盘空间。完整的安装可能会占用几 GB 到十几 GB 不等，取决于你选择安装哪些模块和版本。建议预留至少 10-20 GB 的空间。
• 内存 (RAM)： 至少需要 4 GB RAM，推荐 8 GB 或更高，以便更流畅地运行 Qt Creator (Qt 的集成开发环境) 和编译大型项目。
• 操作系统版本： 查阅 Qt 官方文档确认你想要安装的 Qt 版本支持的操作系统版本。通常最新版本的 Qt 支持当前主流的操作系统版本。

2. 了解 C++ 编译器

Qt 主要使用 C++ 语言进行开发。因此，你的系统需要安装一个 C++ 编译器。好消息是，在 Windows 上，Qt 的安装程序通常可以自带或帮助你安装一个常用的 C++ 编译器（如 MinGW 或 MSVC 的构建工具）。在 macOS 和 Linux 上，系统通常已经预装了 GCC 或 Clang。

• Windows： 你可以选择使用 MinGW (Minimalist GNU for Windows) 或 MSVC (Microsoft Visual C++)。
  • MinGW： 一个轻量级的 GCC/GNU 工具链移植到 Windows。Qt 安装程序通常提供 MinGW 64-bit 或 32-bit 的选项，对初学者来说非常方便。
  • MSVC： Microsoft 官方的编译器，通常与 Visual Studio 一起安装。如果你已经安装了 Visual Studio，可以选择这个选项。
• macOS： 使用 Clang 编译器，通常随 Xcode Command Line Tools 一起安装。如果你没有安装 Xcode 或其命令行工具，可能需要提前安装。
• Linux： 使用 GCC 或 Clang。大多数发行版默认安装了 GCC。

重要提示： 对于初学者，在 Windows 上强烈建议选择 Qt 安装程序自带的 MinGW 选项。这样可以避免单独安装和配置编译器的麻烦。macOS 和 Linux 用户通常不需要单独安装编译器，系统自带的即可。

3. 创建 Qt 账户

为了下载 Qt 安装程序（尤其是最新的在线安装程序），你需要一个 Qt 账户。注册是免费的，并且过程非常简单。稍后下载时会用到这个账户。

• 访问 Qt 官方网站：https://www.qt.io/
• 找到并点击注册或登录的链接，按照提示填写信息并完成注册。

第二部分：获取 Qt 安装程序

现在我们准备好下载 Qt 安装程序了。访问 Qt 的官方下载页面是第一步。

1. 访问下载页面

打开你的网页浏览器，访问 Qt 的下载页面：https://www.qt.io/download

2. 选择下载类型

Qt 提供了不同的下载选项，包括针对商业用户和开源用户的版本。对于个人学习和非商业开源项目，你可以选择免费的开源版本。

在下载页面上，你会看到类似 “For commercial and open source users” 的部分。向下滚动或查找适合你的选项。通常会有一个按钮或链接指示下载。

• 提示： Qt 官方会引导你下载一个小的在线安装程序。在线安装程序的好处是体积小，可以根据你的选择下载最新的组件。缺点是安装过程中需要稳定的网络连接。
• 离线安装程序： 过去 Qt 也提供体积庞大的离线安装程序，包含所有组件，无需网络即可安装。但现在官方更推荐使用在线安装程序，离线安装程序不太容易直接找到，通常需要从特定仓库获取。对于初学者，在线安装程序更方便获取最新版本和常用组件。

点击下载按钮，下载适用于你操作系统的在线安装程序（例如：qt-unified-windows-x64-installer.exe、qt-unified-macOS-x64-installer.dmg、qt-unified-linux-x64-installer.run）。

3. 运行安装程序前的准备

• Windows： 下载 .exe 文件。找到下载的文件，建议右键点击并选择“以管理员身份运行”，以避免潜在的权限问题。
• macOS： 下载 .dmg 文件。双击 .dmg 文件，它会挂载一个虚拟磁盘。在弹出的窗口中，双击安装程序图标（通常是一个可执行文件 qt-unified-macOS-x64-installer.run）。
• Linux： 下载 .run 文件。你可能需要给它执行权限。打开终端，导航到下载文件所在的目录，运行以下命令：
  bash
chmod +x qt-unified-linux-x64-installer.run
./qt-unified-linux-x64-installer.run
  你可能需要输入你的用户密码来执行此命令。

第三部分：手把手安装过程 (以 Windows 为例，会提及 macOS 和 Linux 的区别)

运行安装程序后，将弹出安装向导。我们将一步步完成它。不同的 Qt 版本和安装程序界面可能略有差异，但整体流程相似。

1. 欢迎界面

通常安装程序会以一个欢迎界面开始。点击 Next (下一步)。

2. Qt 账户登录

在线安装程序需要你登录 Qt 账户。输入你在第一部分创建的账户的邮箱和密码。

截图示意 (Windows 安装程序界面可能类似)：

+-------------------------------------+
| Qt Online Installer |
|-------------------------------------|
| Welcome |
| User Account | <-- 当前步骤
| ... |
| |
| Please enter your Qt Account credentials. |
| |
| Email: [_________________________]|
| Password: [______________________]|
| |
| [ ] Remember Me |
| |
| < Back Next > Cancel|
+-------------------------------------+

点击 Next。如果你没有账户，这里也会提供注册链接。

3. 非商业开源用户声明 (For commercial and open source users)

如果你下载的是开源版本，安装程序会要求你确认你使用 Qt 是用于开源项目的开发，并且遵守 LGPL (或 GPL) 许可证协议。请仔细阅读条款，确认你的用途符合要求，然后勾选同意。

截图示意：

+-------------------------------------+
| Qt Online Installer |
|-------------------------------------|
| ... |
| For commercial and open source users| <-- 当前步骤
| ... |
| |
| [ Text box with LGPL/GPL terms ] |
| |
| [ ] I have read and agree to the terms... |
| [ ] I am not using Qt under the terms... | <-- 选择第一个选项
| |
| < Back Next > Cancel|
+-------------------------------------+

勾选同意后，点击 Next。

4. 收集用户数据 (Optional, usually can skip)

一些安装程序可能会询问是否愿意匿名共享使用数据以帮助改进 Qt。这个通常是可选的，你可以根据自己的偏好选择是否勾选。点击 Next。

5. 选择安装目录 (Installation Folder)

这一步非常重要。你需要选择 Qt 安装的目录。

• 默认路径： 安装程序会提供一个默认路径，例如 C:\Qt (Windows)、/Users/<YourName>/Qt (macOS)、/home/<YourName>/Qt (Linux)。
• 建议：
  • 强烈建议不要安装在带有空格或特殊字符的路径下，这在某些构建工具或编译过程中可能引发问题。例如 C:\Program Files 就不是一个好选择。
  • 使用默认路径通常是安全的。如果你想更改，选择一个简单、没有空格的路径，例如 D:\Qt 或 C:\Development\Qt。
  • 记住你选择的路径，以后可能会用到。

截图示意：

+-------------------------------------+
| Qt Online Installer |
|-------------------------------------|
| ... |
| Installation Folder | <-- 当前步骤
| ... |
| |
| Install to: [ C:\Qt_____________] [Browse...]|
| |
| |
| < Back Next > Cancel|
+-------------------------------------+

选择好路径后，点击 Next。

6. 选择组件 (Select Components) – 核心且关键步骤！

这是安装过程中最关键的一步，决定了你会安装哪些 Qt 版本、哪些模块和哪些工具。界面通常是一个树状结构，你可以展开不同的节点来查看和选择。

让我们详细分解这个界面和你需要做出的选择：

截图示意 (树状结构示例)：

+-------------------------------------------------------+
| Qt Online Installer |
|-------------------------------------------------------|
| ... |
| Select Components | <-- 当前步骤
| ... |
| |
| [ ] Select All |
| [▼] Qt |
| [▼] Qt 6.x.x (Latest) | <-- 选择 Qt 版本
| [ ] Archive |
| [▼] <你的操作系统> |
| [ ] msvc2019 64-bit | <-- 选择编译器架构 (Windows)
| [√] mingw 64-bit | <-- 推荐初学者 (Windows)
| [ ] ... 其他 MSVC 或 MinGW 版本 |
| [ ] Desktop OpenGL (macOS) | <-- macOS 选项
| [√] GCC 64-bit (Linux) | <-- Linux 选项
| [▼] Additional Libraries |
| [√] Qt 5 Compatibility Library |
| [ ] Qt Charts | <-- 选择额外模块
| [ ] Qt Data Visualization |
| [√] Qt Quick 3D |
| [√] Qt Quick Controls 2 |
| [√] Qt SQL |
| [√] Qt Widgets | <-- 推荐初学者 (核心 GUI 模块)
| [ ] ... 其他模块 |
| [ ] Qt 5.x.x (Older) | <-- 旧版本 (非必要不选)
| [▼] Developer and Designer Tools | <-- 开发者工具
| [√] Qt Creator 12.x.x (or latest) | <-- 强烈建议勾选！IDE
| [▼] Toolchain |
| [√] MinGW 11.2.0 64-bit (或与Qt版本匹配的) | <-- 如果选了MinGW Qt版本，这里要勾选配套工具链
| [ ] CMake 3.x.x | <-- 推荐勾选
| [ ] Ninja 1.10 | <-- 可选，更快的构建工具
| [ ] Debugger (比如 CDB 或 GDB) | <-- 推荐勾选
| [ ] Performance Analyzer |
| [ ] Qt Design Studio | <-- 专注于 QML 设计，初学者可选装或不装
| [ ] Documentation | <-- 推荐勾选
| [ ] Examples and Tutorials | <-- 强烈建议勾选！学习资源
| |
| Space required: X.XX GB |
| < Back Next > Cancel|
+-------------------------------------------------------+

选择指南 (针对初学者)：

1. Qt 版本： 通常选择最新的稳定版本（例如 Qt 6.x.x）。展开它。
2. 操作系统架构： 在你选择的 Qt 版本下，找到对应你操作系统的节点。
   • Windows： 你会看到不同的编译器选项，比如 msvc2019 64-bit (需要安装Visual Studio 2019)、msvc2017 64-bit 等，以及 mingw 64-bit、mingw 32-bit。
     • 推荐初学者：勾选 mingw 64-bit (如果你的系统是 64 位)。这是最简单的方式，因为它包含了编译器。
     • 如果你已经安装了 Visual Studio 并且想使用 MSVC，可以勾选对应的 MSVC 版本。
   • macOS： 通常是 Desktop OpenGL 或类似的选项，选择你需要的架构（例如 x64）。
   • Linux： 通常是 GCC 64-bit 或类似的选项。
   • 重要： 你可以选择多个版本或架构，但这会占用更多空间。初学者通常只需要选择一个最新的、适合你系统的架构即可。
3. 附加库 (Additional Libraries) / 模块： 在你选择的 Qt 版本和架构下，你会看到各种 Qt 模块。
   • 核心推荐：
     • Qt Widgets：用于创建传统的桌面风格界面（经典的按钮、文本框等）。强烈建议勾选！
     • Qt Quick / Qt Quick Controls 2 / Qt Quick 3D：用于创建现代、流畅、动画丰富的界面（使用 QML 语言）。如果你对现代 UI 感兴趣，可以勾选。Qt Quick Controls 2 提供了现成的控件。
   • 其他常用模块： 根据你的兴趣和需求选择，例如：
     • Qt Charts (图表)
     • Qt SQL (数据库)
     • Qt Network (网络编程)
     • Qt Multimedia (多媒体)
     • Qt GUI (图形用户界面基础，通常是必需的)
     • Qt Core (核心功能，通常是必需的)
   • 初学者建议： 勾选 Qt Widgets、Qt Quick Controls 2 (如果对 QML 感兴趣)、Qt SQL (如果可能需要数据库)，以及核心的 Qt Base (通常会自动勾选)。
4. 开发者和设计师工具 (Developer and Designer Tools)： 这一部分包含重要的开发工具。
   • Qt Creator： Qt 官方的集成开发环境 (IDE)。强烈建议勾选！ 这是你编写、构建和调试 Qt 项目的主要工具。
   • Toolchain： 包含你选择的 Qt 版本配套的编译器、调试器等。
     • 如果你在 Qt 版本下选择了 mingw 64-bit，那么在这里通常需要勾选配套的 MinGW 64-bit 工具链。务必检查并勾选！
     • CMake、Debugger (如 GDB, CDB) 也是非常重要的工具，推荐勾选。
   • Documentation： Qt 文档。强烈建议勾选！ 这是学习和查阅 Qt API 的宝贵资源。
   • Examples and Tutorials： 示例代码和教程。强烈建议勾选！ 通过学习示例代码是入门的最佳方式之一。

总结初学者推荐勾选项：

• 在最新的 Qt 版本下，选择适合你系统的 mingw 64-bit (Windows) 或 GCC 64-bit (Linux) 或 Desktop OpenGL (macOS)。
• 在该版本下，勾选 Qt Widgets 和 Qt Quick Controls 2 (如果需要 QML)。
• 在 Developer and Designer Tools 下，勾选 Qt Creator。
• 在 Developer and Designer Tools -> Toolchain 下，勾选与你选择的 Qt 版本架构配套的 MinGW 64-bit 工具链 (Windows) 或确保相应的编译器已安装。
• 勾选 Documentation。
• 勾选 Examples and Tutorials。
• 检查界面下方显示的“Space required”（所需空间），确保你的硬盘空间足够。

选择完成后，点击 Next。

7. 许可证协议 (License Agreement)

阅读并同意最终的许可证协议。勾选“I have read and agree…”并点击 Next。

8. 开始菜单快捷方式 (Windows Only) / 准备安装 (Ready to Install)

在 Windows 上，可能会询问是否创建开始菜单快捷方式。通常保持默认即可。

然后，安装程序会显示一个安装概要，列出你选择安装的所有组件以及安装路径。仔细检查一遍，确认无误。

截图示意：

+-------------------------------------+
| Qt Online Installer |
|-------------------------------------|
| ... |
| Ready to Install | <-- 当前步骤
| |
| Summary of selected components: |
| - Qt 6.x.x |
| - mingw 64-bit |
| - Qt Widgets |
| - Qt Quick Controls 2 |
| - Developer and Designer Tools |
| - Qt Creator ... |
| - Toolchain MinGW ... |
| - Documentation |
| - Examples and Tutorials |
| |
| Installation path: C:\Qt |
| Total size: X.XX GB |
| |
| < Back Install > Cancel|
+-------------------------------------+

确认无误后，点击 Install。

9. 安装过程 (Installing)

安装程序现在开始下载和安装你选择的组件。这是一个耗时的过程，取决于你的网络速度和选择的组件数量。请耐心等待。

安装过程中可能会显示下载进度、安装进度以及当前正在安装的文件。

截图示意：

+-------------------------------------+
| Qt Online Installer |
|-------------------------------------|
| ... |
| Installing | <-- 当前步骤
| |
| Downloading: component_name.zip |
| Progress: [███████████████ ] |
| Installing: file_name.dll |
| Overall Progress: [█████████ ]|
| |
| |
| Cancel |
+-------------------------------------+

如果下载过程中断或失败，安装程序通常会提供重试选项。确保网络连接稳定。

10. 安装完成 (Installation Complete)

安装完成后，安装程序会显示完成界面。

截图示意：

+-------------------------------------+
| Qt Online Installer |
|-------------------------------------|
| ... |
| Installation Complete | <-- 当前步骤
| |
| Qt has been successfully installed.|
| |
| [√] Launch Qt Creator | <-- 推荐勾选，安装完立即启动 IDE
| |
| |
| < Back Finish > |
+-------------------------------------+

通常会有一个选项勾选“Launch Qt Creator”（启动 Qt Creator）。建议勾选此项，以便立即验证安装是否成功并开始使用。

点击 Finish。

第四部分：验证安装

安装完成后，最直接的验证方法是启动 Qt Creator 并创建一个简单的项目。

1. 启动 Qt Creator

如果你在安装完成时勾选了“Launch Qt Creator”，它应该会自动启动。否则，你可以从开始菜单 (Windows)、应用程序文件夹 (macOS) 或应用启动器 (Linux) 中找到 Qt Creator 并启动它。

第一次启动 Qt Creator，它可能会加载一些配置，需要一些时间。

2. 创建一个简单的项目

在 Qt Creator 中：

1. 选择菜单栏中的 File (文件) -> New Project... (新建项目...)。
2. 在弹出的窗口中，选择项目模板。对于初学者，推荐选择：
   • Application (应用程序) -> Qt Widgets Application (Qt Widgets 应用程序) (如果你想创建传统的桌面应用)
   • 或者 Application (应用程序) -> Qt Quick Application (Qt Quick 应用程序) (如果你想创建现代的 QML 应用)
3. 点击 Choose... (选择...)。
4. 为项目命名，选择项目存放的路径（建议选择一个空目录）。点击 Next。
5. 重要：Kit Selection (选择套件): 这一步是验证安装成功的关键。Qt Creator 会检测到你安装的 Qt 版本和配套的编译器，并组合成不同的“Kit”（套件）。一个 Kit 代表一套完整的构建环境（Qt 版本 + 编译器 + 调试器）。你应该能看到你刚刚安装的 Qt 版本对应的 Kit 被自动选中或出现在列表中。
   • 例如，如果你安装了 Qt 6.x.x mingw 64-bit，你应该能看到一个名为 Desktop Qt 6.x.x MinGW 64-bit 或类似的 Kit。
   • 确保至少有一个有效的 Kit 被选中！ 如果这里显示“No valid kits found”（没有找到有效的套件），说明你的 Qt 版本和编译器没有正确匹配或安装。这可能是安装过程中最常见的问题。
   • 如果 Kit 旁边有红色叹号，点击它查看错误信息，通常是编译器或调试器没有找到。
   • 如果你安装时选择了 MinGW，但 Kit 无效，检查你是否也在 Developer and Designer Tools -> Toolchain 中勾选了配套的 MinGW 工具链。如果忘记了，可以使用维护工具添加。
6. 选择一个有效的 Kit 后，点击 Next。
7. 按照向导继续设置项目的基类、类名、构建系统 (CMake 或 qmake，初学者默认即可)。点击 Next 直到 Finish。

3. 构建和运行项目

项目创建完成后，Qt Creator 会打开代码编辑器。默认的 Qt Widgets 或 Qt Quick 项目通常会生成一个最简单的窗口或界面。

1. 在 Qt Creator 左侧的面板中，找到并点击绿色的“运行”按钮（通常是一个绿色的三角形）。或者选择菜单栏 Build (构建) -> Run (运行)。
2. Qt Creator 会先构建项目（编译代码、链接等）。在下方的“构建输出”面板可以看到构建过程。
3. 如果构建成功，程序会自动运行。你应该会看到一个空白的窗口弹出。

如果构建成功并弹出了程序窗口，恭喜你！你的 Qt 开发环境已经成功搭建并可以正常工作了！

第五部分：安装后的补充和注意事项

1. 维护工具 (Maintenance Tool)

在你的 Qt 安装目录下（例如 C:\Qt），会有一个名为 MaintenanceTool.exe (Windows) 或 MaintenanceTool (macOS/Linux) 的可执行文件。

这个工具非常有用，它可以让你：

• 添加组件： 如果你之前漏装了某个 Qt 版本、某个模块或某个工具（比如 MinGW 工具链），可以通过它重新运行安装程序，只选择需要添加的组件进行安装。
• 移除组件： 卸载不再需要的 Qt 版本或模块。
• 更新 Qt： 检查并安装 Qt 的更新版本。

如果你在创建项目时遇到“No valid kits found”的问题，很可能需要运行 MaintenanceTool 重新安装配套的编译器工具链。

2. 环境变量

在 Windows 上，Qt 安装程序通常会自动配置一些必要的环境变量（如 PATH），以便系统能找到 Qt 的可执行文件和库。在 macOS 和 Linux 上，通常也是如此。大多数情况下你不需要手动配置。

如果你在命令行中需要使用 Qt 的工具（如 qmake），并且遇到了“command not found”的错误，可能需要手动将 Qt 安装目录下的 bin 目录添加到系统的 PATH 环境变量中。但是对于初学者，主要在 Qt Creator 中进行开发，所以这通常不是必需的。

3. 学习资源

现在你已经安装好了 Qt，是时候开始学习了！

• Qt Creator： 熟悉 Qt Creator 的界面和功能。它是一个非常强大的 IDE。
• 官方文档 (Documentation)： 这是学习 Qt 最权威的资源。在 Qt Creator 中，你可以通过菜单 Help (帮助) 或按 F1 键（当光标位于某个类名或函数名上时）来快速查阅文档。
• 官方示例和教程 (Examples and Tutorials)： 这是实践学习的最佳起点。在 Qt Creator 中，通过菜单 Help (帮助) -> Examples and Tutorials (示例和教程) 可以打开示例浏览器，里面包含大量各种功能的示例代码，直接运行和阅读它们能帮助你快速理解 Qt 的用法。
• 在线资源： 官方网站、博客、论坛、第三方教程网站、Qt 相关的书籍等。

第六部分：常见问题及故障排除

1. “No valid kits found” (没有找到有效的套件)

• 原因： Qt Creator 无法找到一个完整的开发环境（Qt 版本 + 编译器 + 调试器）。最常见的原因是你安装了某个 Qt 版本，但没有安装或Qt Creator没有检测到与之配套的编译器和调试器。
• 解决方案：
  1. 运行 Maintenance Tool。
  2. 选择“Add or remove components”（添加或移除组件）。
  3. 导航到你安装的 Qt 版本下，以及 Developer and Designer Tools -> Toolchain 下。
  4. 确保你选择了 Qt 版本对应的编译器架构（例如 mingw 64-bit）并且在 Toolchain 中也勾选了配套的 MinGW 工具链。如果之前没勾选，现在勾选并继续安装。
  5. 如果使用的是 MSVC 版本，确保你的系统安装了对应版本的 Visual Studio 或 MSVC Build Tools。
  6. 重新启动 Qt Creator。
  7. 在 Qt Creator 中，进入 Tools (工具) -> Options (选项) -> Kits (套件)。检查“Kits”和“Compilers”（编译器）、“Debuggers”（调试器）选项卡，确保它们被正确识别。如果某个组件前面有红色叹号，点击查看详情，通常是路径不正确。

2. 安装程序下载中断或失败

• 原因： 网络连接不稳定、防火墙或代理设置问题。
• 解决方案：
  1. 检查网络连接。
  2. 临时关闭防火墙或杀毒软件（请注意安全）。
  3. 如果你使用了代理，确保安装程序配置了正确的代理设置（通常在安装程序的设置或欢迎界面有相关选项）。
  4. 重新运行安装程序。它通常会从中断的地方继续下载。

3. 安装路径问题

• 原因： 安装路径包含空格、特殊字符或中文。
• 解决方案： 卸载当前的 Qt，然后重新运行安装程序，选择一个简单、纯英文、不含空格和特殊字符的路径进行安装（例如 C:\Qt 或 D:\Qt）。

4. 权限问题

• 原因： 在 Windows 上没有以管理员身份运行安装程序，导致无法写入系统目录或进行必要的注册。
• 解决方案： 重新下载安装程序（如果之前下载的文件可能不完整），右键点击安装程序文件，选择“以管理员身份运行”。

5. 编译时出现链接错误 (LNK errors on Windows, undefined reference on Linux/macOS)

• 原因： 项目没有正确链接到所需的 Qt 模块库。这通常在使用构建系统（如 CMake 或 qmake）时配置不当引起，或者某些必要的 Qt 模块没有安装。
• 解决方案：
  1. 确保你在安装 Qt 时勾选了项目所需的 Qt 模块（例如，如果使用 QPushButton，需要安装 Qt Widgets）。如果没装，运行 Maintenance Tool 添加。
  2. 检查项目文件 (.pro for qmake, CMakeLists.txt for CMake) 是否正确包含了所需的模块（例如，qmake 文件中是否有 QT += widgets）。使用 Qt Creator 创建项目时通常会自动添加常用的模块。

结论

恭喜你！通过以上详细的步骤，你应该已经成功地在你的电脑上安装了 Qt 开发环境，并且验证了它的可用性。虽然安装过程看似步骤较多，但每一步都有其原因，特别是组件选择部分，理解了它的含义，可以帮助你更灵活地配置你的开发环境。

现在，你已经具备了进行 Qt 开发的基础。Qt Creator 提供了丰富的工具来帮助你编写代码、设计界面、调试程序。强烈建议你从运行官方提供的示例代码开始，逐步学习 Qt 的各个模块和特性。查阅官方文档是你遇到问题时的最佳伙伴。

跨平台应用开发的大门已经为你打开，尽情探索 Qt 带来的无限可能吧！祝你在 Qt 的学习旅程中一切顺利，开发出令人惊叹的应用！

---