如何下载和安装 Qt？新手快速入门指南 – wiki基地

作者： /

Qt 下载与安装：超详细新手快速入门指南 (约 3000 字)

引言：开启你的跨平台应用开发之旅

欢迎来到 Qt 的世界！如果你正在寻找一个强大、灵活且能够让你在 Windows、macOS、Linux、Android、iOS 甚至是嵌入式系统上构建精美用户界面和高性能应用程序的框架，那么 Qt 无疑是你的绝佳选择。

Qt 是一个跨平台的 C++ 图形用户界面应用程序开发框架，同时也支持 QML（Qt Meta-Object Language）用于声明式 UI 设计。凭借其“一次编写，随处部署”的理念，Qt 极大地提高了开发效率。

对于初学者来说，迈出第一步——下载和安装 Qt——可能会显得有些 daunting（令人畏惧）。Qt 安装包通常包含多个组件，不同的版本、不同的编译器、不同的附加模块可能会让你感到困惑。别担心！本文将为你提供一份超详细、手把手的指南，带你顺利完成 Qt 的下载和安装过程。我们将涵盖从准备工作到选择组件，再到验证安装的每一个细节，确保你能够快速且正确地搭建好 Qt 开发环境。

请准备好你的电脑、稳定的网络连接，以及耐心，让我们开始这段学习之旅吧！

第一部分：准备工作

在正式开始下载和安装之前，你需要做一些准备工作，以确保过程顺利。

  1. 检查系统要求：

    • 操作系统： Qt 支持主流的操作系统，包括 Windows (通常是 Windows 10 或更高版本)、macOS (通常是最近几个大版本) 和 Linux (各种发行版如 Ubuntu, Fedora, CentOS 等)。请确保你的操作系统版本符合你打算安装的 Qt 版本的最低要求。你可以在 Qt 官方网站的 Release Notes 中找到特定版本的详细系统要求。
    • 硬件： 虽然 Qt 本身对硬件要求不高，但编译和运行大型项目可能需要一定的处理器性能和内存。至少 4GB 内存是推荐的，8GB 或更多会更好。足够的硬盘空间也非常重要，一个完整的 Qt 安装包可能占用数 GB 甚至数十 GB 的空间，取决于你选择安装的组件。至少预留 20-30 GB 的硬盘空间是一个稳妥的选择。

  2. 创建 Qt 账户 (强制要求)：

    • 自 Qt 5.13 版本开始，安装 Qt (包括开源版本) 几乎都需要通过在线安装器进行，而使用在线安装器则强制要求登录 Qt 账户。
    • 如何创建账户：
      • 访问 Qt 官方网站：https://www.qt.io/
      • 寻找注册或登录的入口，通常在网站的右上角。
      • 点击注册 (Sign Up / Register)，填写必要的信息，包括邮箱、密码等。
      • 完成邮箱验证。
    • 请务必记住你的账户信息，在安装过程中需要用到。创建账户是免费的，即使你使用开源版本。

  3. 稳定的网络连接：

    • 在线安装器需要从 Qt 服务器下载大量的组件文件。一个稳定且速度较快的网络连接是完成安装的关键。中断的连接可能导致下载失败或安装不完整。

  4. 关闭不必要的程序：

    • 在安装过程中，最好关闭一些占用系统资源较多或可能干扰安装过程的程序，特别是杀毒软件（某些杀毒软件可能会误报或阻止安装程序访问文件）。如果杀毒软件提示，请仔细阅读并判断是否允许 Qt 安装程序执行必要操作。

第二部分：下载 Qt 在线安装器

Qt 提供了在线安装器 (Online Installer) 和离线安装器 (Offline Installer)。对于大多数新手来说，在线安装器是更推荐的选择，因为它允许你选择性地安装所需的组件，节省下载时间和磁盘空间，并且通常包含最新的维护更新。离线安装器虽然不需要网络即可安装（下载时需要网络），但文件巨大，且不方便选择性安装，更新也相对麻烦。

我们主要介绍如何使用在线安装器。

  1. 访问 Qt 官方下载页面：

    • 打开你的浏览器，访问 Qt 的下载页面。最直接的方式是通过主页导航或搜索引擎搜索 “Download Qt”。
    • 官方下载页面地址通常是：https://www.qt.io/download

  2. 选择适合你的版本：

    • 在下载页面，你会看到不同的选项。对于开源用户（非商业用途），请寻找 “Qt for Open Source Development” 或类似的选项。
    • 点击进入开源下载页面。在这里，你会看到不同操作系统的下载链接。
    • 选择与你操作系统（Windows, macOS, Linux）对应的在线安装器下载链接。例如，在 Windows 上，你会下载一个 .exe 文件；在 macOS 上，你会下载一个 .dmg 文件；在 Linux 上，你会下载一个可执行文件。

  3. 下载安装器：

    • 点击相应的下载链接后，安装器文件会开始下载。文件本身通常不大（几十 MB），它只是一个启动器，实际的组件会在安装过程中下载。
    • 请选择一个你方便找到的目录保存下载的安装器文件。

第三部分：运行 Qt 在线安装器并逐步安装

现在，你已经下载了 Qt 在线安装器。接下来是执行它并完成整个安装过程。这个过程涉及多个步骤，需要仔细阅读屏幕上的提示并做出选择。

  1. 运行安装器文件：

    • 找到你下载的安装器文件（例如，qt-unified-windows-x64-4.x.x-online.exe）。
    • 双击运行该文件。
    • 在 Windows 上，你可能会看到用户账户控制 (UAC) 提示，点击“是”允许程序运行。

  2. Qt Account 登录：

    • 安装程序启动后，第一个界面通常是要求你登录 Qt 账户。
    • 输入你在准备阶段创建的 Qt 账户的电子邮件地址和密码。
    • 点击“Next”（下一步）。
    • 如果登录失败，请检查你的账户信息是否正确，或检查网络连接。如果忘记密码，可以通过“Forgot Password”选项重置。

  3. Welcome (欢迎界面)：

    • 登录成功后，你会看到一个欢迎界面，可能包含一些关于 Qt 的介绍或新闻。
    • 点击“Next”（下一步）。

  4. Qt Open Source License Agreement (Qt 开源许可协议)：

    • 这是一个非常重要的步骤。你需要仔细阅读 Qt 开源许可证（通常是 LGPL v3、GPL v2 或 GPL v3）。
    • 如果你打算使用 Qt 开发闭源商业软件，并且不想公开你的源代码，那么你通常需要购买商业许可证。开源许可证适用于开源项目或内部评估。
    • 对于大多数学习和个人项目的新手，选择开源许可证是合适的。
    • 阅读完毕后，勾选“I have read and agree to the terms of the Qt Open Source License”旁边的复选框，表示你同意许可协议。
    • 点击“Next”（下一步）。
    • 注意： 如果你勾选了错误类型的许可，或者你的使用场景不符合开源许可，未来可能会面临法律问题。请务必理解你所同意的条款。

  5. 选择安装路径 (Installation Folder)：

    • 在这里，你需要选择 Qt 的安装目录。
    • 重要建议：
      • 避免路径中包含中文或特殊字符。 使用英文字母、数字和下划线是安全的。
      • 避免安装到系统盘根目录或 Program Files 目录。 虽然不是绝对禁止，但在某些操作系统版本或权限设置下，安装到这些目录可能会遇到权限问题。推荐创建一个专门的目录，例如 D:\Qt 或 C:\Qt (如果非系统盘空间不足)。
      • 路径不要过长。 某些构建工具对路径长度有限制。
    • 点击“Browse…”按钮选择或创建一个新的安装目录。
    • 确认路径无误后，点击“Next”（下一步）。

  6. Select Components (选择组件)：

    • 这是整个安装过程中最关键、最容易让新手困惑的一步。 在这里，你需要选择要安装的 Qt 版本、编译器、开发工具以及附加模块。
    • 界面通常以树状结构显示可用的组件。

    • 理解主要类别：

      • Qt (或 Qt <版本号>): 这是主要的 Qt 库。下面会列出不同的 Qt 版本（如 Qt 6.x, Qt 5.x）。通常，每个版本下又会包含针对不同编译器和架构的子选项。
      • Tools (工具): 包含 Qt Creator IDE、各种构建工具、调试器等。Qt Creator 是开发 Qt 应用程序的主要集成开发环境，强烈建议安装。
      • Additional Libraries / Add-ons (附加库/模块): 这些是 Qt 提供的一些非核心但有用的模块，例如 Qt Charts (图表), Qt Multimedia (多媒体), Qt Quick 3D 等。对于初学者，你可能不需要全部安装，可以根据未来的学习或项目需求再通过安装器进行修改。
      • Developer and Designer Tools (开发者和设计者工具): 可能包含一些独立工具，如 Qt Designer (用于设计基于 Widget 的 UI), Qt Assistant (帮助文档查看器) 等。
      • Source (源代码): Qt 库的源代码。如果你需要深入研究 Qt 的实现或进行调试，可以安装。对于初学者来说不是必须的，但安装了有助于学习。
      • Documentation (文档): Qt 的官方文档。强烈建议安装！ 离线文档是学习 Qt 的宝贵资源，可以大大减少对网络的依赖。

    • 如何选择：

      • 选择一个或多个 Qt 版本： 对于新手，推荐选择一个长期支持版 (LTS – Long-Term Support)，例如 Qt 6.5.x 或 Qt 5.15.x (如果需要兼容老项目或特定特性)。LTS 版本更稳定，维护周期长。你也可以选择最新的稳定版 (Latest Release)，但它们的支持周期可能较短。
      • 选择编译器工具链 (Kits)： 这是非常重要且与操作系统相关的选择。
        • Windows 上：
          • MinGW (Minimalist GNU for Windows): 一个轻量级的 GCC/G++ 移植版本。安装过程相对简单，不需要额外配置。适合大多数新手学习和开发。安装 Qt 时自带 MinGW 选项，勾选即可。
          • MSVC (Microsoft Visual C++): 使用 Visual Studio 的编译器。如果你已经安装了 Visual Studio (Community, Professional, Enterprise 版本)，并且希望利用 MSVC 的特性或与现有 MSVC 项目集成，可以选择对应的 MSVC 版本 (例如 MSVC 2019, MSVC 2022)。这通常需要在安装 Qt 之前先安装好对应版本的 Visual Studio 和 C++ 开发组件。
          • UWP (Universal Windows Platform): 用于开发 UWP 应用，通常需要 MSVC 编译器和特定的 Windows SDK。新手通常不需要。
        • macOS 上：
          • 通常是基于 Clang 编译器的工具链。确保你的 macOS 上安装了 Xcode Command Line Tools 或完整的 Xcode。安装器会自动检测并提供相应的选项。
        • Linux 上：
          • 通常是基于 GCC 或 Clang 的工具链。确保你的系统上安装了 C++ 编译器 (如 g++ 或 clang++)。安装器会提供对应的选项。
      • 选择 Qt Creator： 在 “Tools” 下找到 Qt Creator，务必勾选安装。它是你的主要开发环境。
      • 选择 Documentation 和 Source： 强烈建议勾选 Documentation (文档)。Source (源代码) 根据你的硬盘空间和需求选择，不强制。
      • 其他模块 (Add-ons)： 初学者可以先不选，等有需求时再运行安装器添加。常见的需要安装的可能包括 Charts, Multimedia, Network Auth, SQLite driver 等，但这取决于你的项目类型。

    • 总结推荐的新手选择 (以 Windows 为例)：

      • 在 “Qt <版本号>” 下，选择一个 LTS 版本 (如 Qt 6.5.x)。
      • 在该版本下，选择一个适合你的编译器：
        • 如果你没有安装 Visual Studio，或者想要最简单的体验，选择 MinGW <版本号>_<架构>。
        • 如果你已经安装了 Visual Studio (并包含 C++ 组件)，并且希望使用 MSVC，选择 MSVC <年份> <架构>。请确保选择的 MSVC 版本与你的 Visual Studio 版本对应。
      • 在 “Tools” 下，勾选 Qt Creator。
      • 在 “Tools” 下的 “Developer and Designer Tools” 中，可以考虑勾选 CMake、Ninja 等构建工具（通常 Qt Creator 会自动配置）。如果需要可视化设计界面，勾选 Qt Designer (有时集成在 Qt Creator 中，有时是独立工具)。
      • 在 “Source” 下，不强制勾选 (新手可忽略)。
      • 在 “Documentation” 下，强烈建议勾选。
      • 在 “Additional Libraries” 下，新手可先全部不勾选。

    • 选择完成后，安装器会在底部显示所需的总磁盘空间。请确认你的硬盘空间足够。

    • 点击“Next”（下一步）。

  7. Qt Developer and Designer Tools Agreement (开发者和设计者工具许可协议)：

    • 某些工具可能有独立的许可协议，特别是像 CMake、Ninja 等第三方工具。
    • 阅读并勾选同意。
    • 点击“Next”（下一步）。

  8. Ready to Install (准备安装)：

    • 这个界面会显示你选择的组件列表和安装路径。
    • 再次确认你的选择。如果需要修改，可以点击“Back”返回。
    • 确认无误后，点击“Install”（安装）。

  9. Installation Process (安装过程)：

    • 安装器现在开始下载和安装所选的组件。这可能需要相当长的时间，具体取决于你的网络速度和你选择的组件数量。
    • 界面会显示当前正在下载/安装的文件、进度条和预计剩余时间。
    • 请保持网络连接稳定，不要关闭安装程序或让电脑进入睡眠状态。 如果下载中断，安装程序可能会提示重试。
    • 耐心等待直到安装完成。

  10. Installation Complete (安装完成)：

    • 当所有组件下载和安装完成后，安装器会显示安装成功的消息。
    • 通常会有一个复选框选项，例如“Launch Qt Creator”或“Show Readme”。你可以选择是否立即启动 Qt Creator。
    • 点击“Finish”（完成）退出安装程序。

第四部分：验证安装

安装完成后，最重要的事情就是验证它是否成功并且可以正常使用。

  1. 启动 Qt Creator：

    • 如果你在安装结束时没有勾选启动 Qt Creator，现在可以通过以下方式启动：
      • Windows： 在开始菜单中找到 Qt 相关的程序组，点击 Qt Creator。
      • macOS： 在 Applications 文件夹中找到 Qt 目录，里面应该有 Qt Creator 应用。
      • Linux： 在应用程序菜单中查找，或者在终端中输入 qtcreator 命令（如果安装程序配置了环境变量）。
    • 首次启动 Qt Creator 可能需要一些时间进行配置。

  2. 检查 Kits (工具套件)：

    • Qt Creator 使用“Kits”来管理不同的 Qt 版本、编译器、调试器和设备配置。一个 Kit 代表一个完整的开发环境。
    • 在 Qt Creator 中，通常可以通过菜单 Tools -> Options (Windows/Linux) 或 Qt Creator -> Preferences (macOS) 进入设置。
    • 在设置窗口中，找到左侧的 Kits (或 Build & Run -> Kits)。
    • 你应该能看到安装程序自动为你配置好的 Kits，每个 Kit 应该对应你安装的一个 Qt 版本和一个编译器（例如，Desktop Qt 6.5.x MinGW 64-bit 或 Desktop Qt 6.5.x MSVC 2022 64-bit）。
    • 确保这些 Kits 是有效的（通常没有警告或错误标志）。如果 Kit 无效，可能是编译器未找到或 Qt 版本配置有问题。

  3. 创建一个简单的测试项目 (可选但推荐)：

    • 通过创建一个新项目来全面验证环境。
    • 在 Qt Creator 中，选择菜单 File -> New File or Project...。
    • 选择一个简单的项目模板，例如 Application -> Qt Widgets Application (基于 C++ 和 Widgets) 或 Application -> Qt Quick Application (基于 QML)。对于新手，Widgets Application 可能更直观。
    • 按照向导步骤填写项目名称、路径等。
    • 在“Kit Selection”步骤，选择你刚刚在步骤2中检查到的 Kit。
    • 完成项目创建。
    • Qt Creator 会生成一个基本的项目代码。
    • 点击左下角的“构建”按钮 (锤子图标) 和“运行”按钮 (绿色播放图标)。
    • 如果项目成功编译并运行，显示一个简单的窗口，那么恭喜你，Qt 环境已经安装并配置成功了！

第五部分：常见问题与故障排除

在安装过程中，你可能会遇到一些问题。这里列举一些常见问题及其可能的解决方案：

  1. 下载速度慢或中断：

    • 问题： 安装程序下载组件时速度很慢，或者频繁中断。
    • 解决方案：
      • 检查你的网络连接是否正常工作。
      • 尝试更换一个网络环境，例如从 Wi-Fi 切换到有线连接。
      • 暂时关闭其他占用带宽的应用程序。
      • Qt 的下载服务器可能因地区或时间段而异，有时候换个时间段重试可能会改善。
      • 如果实在无法通过在线安装器完成，可以考虑尝试下载离线安装器（但文件巨大）。

  2. Qt Account 登录失败：

    • 问题： 在安装程序中无法登录 Qt 账户。
    • 解决方案：
      • 确认你输入的邮箱和密码是否正确，注意区分大小写。
      • 在 Qt 官方网站上尝试登录你的账户，确认账户是否激活或存在问题。
      • 检查网络连接是否畅通，能否访问 Qt 服务器。
      • 如果忘记密码，使用“Forgot Password”功能重置。
      • 防火墙或代理设置可能阻止了登录，尝试暂时关闭防火墙或检查代理设置。

  3. 安装过程中报错：

    • 问题： 安装程序在下载或解压文件时提示错误。
    • 解决方案：
      • 错误信息通常会提供一些线索。仔细阅读错误提示。
      • 确保安装目录有足够的磁盘空间。
      • 检查安装目录是否有写入权限。尝试以管理员身份运行安装程序 (在 Windows 上右键点击安装程序 -> 以管理员身份运行)。
      • 杀毒软件可能误报或阻止了某些文件操作，尝试暂时关闭杀毒软件（请务必谨慎，并在安装完成后重新启用）。
      • 如果特定组件下载失败，可能是该组件文件损坏或服务器问题，可以尝试取消该组件的安装，或者稍后通过维护工具添加。
      • 网络问题也可能导致文件下载不完整或损坏，重试下载可能解决问题。

  4. 安装完成后 Qt Creator 无法启动或 Kits 无效：

    • 问题： 安装成功，但 Qt Creator 启动失败，或者在 Kit 设置中显示 Kit 无效，无法构建项目。
    • 解决方案：
      • Qt Creator 无法启动： 尝试重新安装 Qt Creator 组件（可以通过再次运行安装器，选择 Maintenance Tool -> Add or remove components）。检查系统环境变量 PATH 是否包含了 Qt Creator 的安装路径（通常安装器会自动添加，但有时会出问题）。
      • Kits 无效 (编译器未找到)： 这是最常见的问题之一。
        • 如果你选择了 MSVC Kit，确保你安装了对应版本的 Visual Studio，并且在 VS 安装时勾选了“使用 C++ 的桌面开发”等必要的 C++ 组件。然后重启电脑或 Qt Creator。
        • 如果你选择了 MinGW Kit，确保在安装 Qt 时勾选了对应的 MinGW 组件。有时 MinGW 的环境变量需要手动配置，但 Qt 安装器通常会处理。检查 Qt 安装目录下 MinGW 目录是否存在，以及其中是否有 g++ 等编译器可执行文件。
        • 如果你选择了 GCC/Clang Kit (Linux/macOS)，确保你的系统上已经通过包管理器安装了 g++ 或 clang++。
        • 在 Qt Creator 的 Kits 设置中，手动检查编译器 (Compilers) 和 Debugger (调试器) 路径是否正确指向了你系统上或 Qt 安装目录下的对应文件。
      • Kits 无效 (Qt Version 未找到)： 检查 Qt Creator 的 Kits 设置中，Qt Versions 选项卡下是否正确识别了你安装的 Qt 版本目录。如果没有，可以手动点击 Add 添加 Qt 安装目录下的对应 qmake 或 cmake 文件。
      • 确保你选择的 Kits 与你的项目类型兼容。例如，Widget 项目需要 C++ 和 Widgets 库。

  5. 安装目录路径过长导致问题：

    • 问题： 在 Windows 上，如果安装路径过长，某些构建工具可能会报错。
    • 解决方案：
      • 卸载当前安装。
      • 重新运行安装程序，选择一个更短、层级更浅的安装路径，例如 C:\Qt 或 D:\Qt。

  6. 维护工具 (Maintenance Tool)：

    • 问题： 安装完成后想添加、移除或更新组件。
    • 解决方案：
      • 在 Qt 安装目录下，你会找到一个名为 MaintenanceTool.exe (Windows) 或 MaintenanceTool (macOS/Linux) 的可执行文件。
      • 运行它。它会让你登录 Qt 账户。
      • 登录后，你可以选择“Add or remove components”来增删模块，或者选择“Update components”来更新已安装的组件，或者选择“Uninstall all components”来卸载 Qt。

第六部分：安装完成后的下一步

恭喜你！你已经成功安装了 Qt 开发环境。接下来，你可以开始你的 Qt 学习之旅了。

  1. 熟悉 Qt Creator： Qt Creator 是一个功能强大的 IDE，花点时间熟悉它的界面、菜单、快捷键和主要功能（如项目管理、代码编辑、构建、调试）。
  2. 查阅官方文档： 你安装的离线文档是学习 Qt 最权威、最全面的资源。学会如何搜索和阅读文档。文档中包含了大量的类说明、教程和示例。
  3. 学习 Qt Widgets 或 Qt Quick (QML)： Qt 主要有两种构建 UI 的方式：基于 C++ 的 Widgets 和基于 QML 的 Qt Quick。
    • Widgets 适合构建传统的桌面应用程序界面。
    • Qt Quick (QML) 适合构建现代、流畅、动画效果丰富的界面，常用于移动端和嵌入式设备，但也可用于桌面应用。
    • 你可以选择其中一种开始学习，或者两者都学习。
  4. 运行示例程序： Qt 安装包通常包含大量的示例程序。在 Qt Creator 中，可以通过 Welcome 模式或菜单找到示例项目。运行这些示例可以让你快速了解 Qt 的各种功能。
  5. 从基础教程开始： 网上和官方文档中有大量的 Qt 入门教程。从创建一个简单的“Hello World”窗口开始，逐步学习如何使用布局、控件、信号与槽、文件操作、网络等。

结论

Qt 的下载和安装过程可能看起来步骤繁多，特别是组件选择的部分。但只要你按照本指南的步骤仔细操作，理解每一步的目的，特别是关于组件选择和编译器配置的部分，你应该能够顺利完成环境搭建。记住，遇到问题时不要灰心，查阅错误信息，参考本文的故障排除部分，或在 Qt 社区寻求帮助。

一旦你成功安装并验证了 Qt 环境，你就已经为开启令人兴奋的跨平台应用开发之旅做好了准备。Qt 强大而灵活，它将极大地提升你的开发效率和应用程序的质量。现在，是时候 dive deep（深入探索）到 Qt 的世界中，开始构建属于你自己的出色应用程序了！祝你好运！

发表评论

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

滚动至顶部