Qt 下载指引：新手也能轻松安装 – wiki基地

作者： /

Qt 下载指引：新手也能轻松安装，迈出你的编程第一步！

前言：探索Qt的神奇世界

恭喜你，你正在考虑或即将开始你的Qt编程之旅！Qt是一个强大、灵活且跨平台的C++图形用户界面应用程序开发框架，被广泛应用于桌面应用、嵌入式系统、移动应用（虽然近年趋势有所变化，但仍有应用）等多个领域。从著名的软件如Krita绘画软件、VLC媒体播放器，到工业自动化控制系统、车载信息娱乐系统，都有Qt的身影。学习Qt，意味着你掌握了一项能让你创造出美观且功能丰富的应用程序的强大技能。

然而，对于初学者来说，Qt的安装过程有时可能会显得有些复杂，尤其是面对众多版本、组件和许可选项时。但请放心，这并非高不可攀的任务。本篇文章将手把手、一步步地引导你完成Qt的下载与安装过程，即使你是完全没有接触过Qt的新手，也能轻松上手。

我们将详细讲解每一个关键步骤，解释你可能会遇到的选项，并提供一些实用的建议。请耐心跟随本指引，你将很快拥有一个配置好的Qt开发环境， ready to code!

准备工作：安装前的“武装”

在开始下载和安装Qt之前，我们需要做一些简单的准备工作，确保你的电脑满足基本要求，并为你选择合适的Qt版本做好铺垫。

  1. 操作系统确认： Qt支持多种主流操作系统，包括Windows、macOS和Linux。请确保你的操作系统是这些平台之一，并且是相对较新的版本。例如，如果你使用Windows，建议是Windows 10或更新版本；macOS建议是近几个大版本的系统；Linux则需要一个主流发行版，如Ubuntu、Fedora等。Qt的某些最新版本可能不支持过于老旧的操作系统。
  2. 检查硬件配置： Qt开发环境，尤其是IDE (集成开发环境) Qt Creator和编译过程，需要一定的系统资源。确保你的电脑至少有4GB或更多内存（推荐8GB以上），以及足够的硬盘空间（Qt安装包可能比较大，完全安装加上后续项目文件，预留50GB甚至更多的空间是比较稳妥的）。一个速度较快的处理器也能显著提升开发效率。
  3. 稳定的网络连接： Qt推荐使用在线安装器进行安装。这意味着安装程序会从互联网上下载所需的文件。因此，一个稳定且速度较快的网络连接是必不可少的。如果你的网络不稳定，可能会导致下载中断或安装失败。

  4. 了解许可类型： Qt提供两种主要的许可类型：

    • Qt Open Source (开源版): 这是免费的，非常适合个人学习、研究、非商业项目，以及满足LGPL/GPL开源协议要求的商业项目。绝大多数新手都是从开源版开始的。如果你不确定，或者你的项目是个人学习或开源性质，选择开源版即可。
    • Qt Commercial (商业版): 这是收费的，提供了更多的功能模块、技术支持，并且允许你在不遵守LGPL/GPL协议的情况下开发闭源商业软件。商业版通常有试用期。

    作为新手，我们强烈建议你选择 Qt Open Source (开源版)。本教程也将围绕开源版的安装进行讲解。

  5. Qt账户： 使用Qt的在线安装器需要登录Qt账户。如果你还没有Qt账户，建议你在下载安装器之前或下载过程中注册一个。注册是免费且快速的。

选择适合你的Qt版本和下载方式

Qt有很多不同的版本，包括主要版本号（如Qt 5、Qt 6）和维护版本号（如Qt 6.5.3）。同时，还有不同的下载方式。

  1. 选择Qt版本：LTS vs. 最新版

    • LTS (Long-Term Support) 版本： 长期支持版本，更加稳定，Bug修复周期长。对于新手来说，选择最新的LTS版本通常是最好的选择。例如，在Qt 6系列中，Qt 6.5 是一个LTS版本（写这篇文章时）。LTS版本能保证你使用一个成熟、稳定的开发环境。
    • 最新版本： 包含最新的功能和改进，但也可能相对不稳定，存在一些新的Bug。除非你需要某个最新版本才有的特定功能，否则不建议新手一开始就选择非LTS的最新版。
    • Qt 5 vs. Qt 6： Qt 6是Qt的下一代主要版本，带来了许多底层改进和新的特性。Qt 5仍然被广泛使用，尤其是一些老项目。对于新项目和学习，推荐从最新的Qt 6 LTS版本开始学习，因为它代表了Qt未来的发展方向。

  2. 下载方式：在线安装器（推荐）

    • Qt官方推荐使用在线安装器 (Online Installer)。它的优点是：
      • 体积小，下载速度快。
      • 安装过程中可以灵活选择需要安装的Qt版本、编译器、附加组件等，按需下载，节省时间和硬盘空间。
      • 能够方便地管理（更新、添加/移除组件）已安装的Qt版本。
    • 离线安装器 (Offline Installer): 通常体积巨大，包含了某个特定Qt版本的所有组件和编译器。适用于网络环境差或者需要在多台没有网络的机器上安装的情况。对于新手和大多数用户来说，在线安装器更加方便灵活。

因此，本指南将重点介绍如何使用在线安装器安装最新的Qt 6 LTS开源版本。

获取在线安装器：找到“入口”

现在，我们去Qt官方网站下载在线安装器。

  1. 访问Qt官方下载页面： 打开你的网页浏览器，访问Qt的官方下载页面。通常的地址是：
    https://www.qt.io/download

    注意：Qt的官网页面可能会有调整，如果链接有变，你可以在Qt官网主页寻找 “Download” 或 “Get Qt” 的入口。

  2. 选择适合你的操作系统： 进入下载页面后，你会看到不同操作系统的下载选项。请选择与你当前使用的操作系统对应的下载器，例如 “Download for Windows”, “Download for macOS”, “Download for Linux”。

  3. 选择下载类型： 在下载页面，你可能会看到商业版试用和开源版下载的选项。请明确选择 “Download Qt Open Source” 或类似的字样。有时它会引导你先注册或登录Qt账户。按照页面提示进行即可。

  4. 下载安装器文件： 点击对应的下载按钮后，你会下载到一个小的安装器执行文件。

    • Windows: qt-unified-windows-x64-*-online.exe (文件名中的 * 代表版本号和日期)
    • macOS: qt-unified-macos-x64-*-online.dmg
    • Linux: qt-unified-linux-x64-*-online.run

    请记住这个文件的下载位置，接下来我们将运行它。

运行Qt安装器：一步步指引 (Windows为例，macOS和Linux类似)

下载完成后，找到你下载的安装器文件，双击运行它。在Windows上，可能会弹出用户账户控制（UAC）提示，点击“是”允许程序运行。

接下来，我们将逐步讲解安装器界面中的重要步骤：

  1. Qt Account Login / 注册 (Login/Signup):

    • 安装器启动后，第一个界面通常要求你登录Qt账户。如果你之前已经注册了账户，输入你的邮箱和密码登录。
    • 如果你还没有账户，点击“Sign Up”或“Register here”之类的链接，按照提示完成免费账户的注册过程。注册成功后，回到安装器界面进行登录。
    • 为什么需要登录？ 使用在线安装器，Qt需要通过你的账户信息来确认你的许可类型（开源或商业）以及管理你下载的组件。这是在线安装器的必要步骤。
    • 成功登录后，点击“Next”。

  2. Welcome to the Qt Installer:

    • 这是一个欢迎和介绍界面，通常包含一些关于Qt版本和安装器的信息。阅读后点击“Next”。

  3. License Agreements (许可协议):

    • 这里会显示Qt的许可协议（对于开源版，主要是LGPLv3、GPLv2/v3等）。你需要仔细阅读并接受协议才能继续安装。
    • 勾选 “I have read and agree to the terms and conditions.” (我已阅读并同意条款和条件)旁边的复选框。
    • 点击“Next”。

  4. Installation Folder (安装目录):

    • 这里让你选择Qt的安装路径。
    • 默认路径： 安装器会提供一个默认的安装路径，通常在你的用户目录下或Program Files下。例如：C:\Qt (Windows), /Users/YourUsername/Qt (macOS), /opt/Qt 或 /home/YourUsername/Qt (Linux)。
    • 自定义路径： 你也可以点击“Browse…”选择其他安装目录。
    • 建议： 对于新手来说，接受默认的安装路径通常是最好的选择。避免路径中包含中文、空格或特殊字符，这可能会在后续的编译过程中引发问题。确保你选择的硬盘分区有足够的空间。
    • 选择好路径后，点击“Next”。

  5. Select Components (选择组件) – 这是最最关键的一步！**

    • 这个界面以树状结构展示了所有可用的Qt版本和组件。你需要在这里选择要安装的具体内容。新手在这里最容易感到困惑。让我们详细分解一下：

    • 理解组件结构：

      • 最顶层通常是主要的Qt版本系列，如 “Qt 6.5.3″。
      • 展开一个Qt版本（如 “Qt 6.5.3″），你会看到该版本下的不同编译器/平台变体 (Compiler/Platform Variants)。这是非常重要的选择项！
      • 在每个编译器变体下，又会列出各种附加组件，如 “Qt Charts”, “Qt Data Visualization”, “Qt Multimedia” 等。
      • 树状结构的底部通常是 “Developer and Designer Tools” (开发者和设计工具)。

    • 如何选择？新手推荐配置：

      • 选择Qt版本： 在你选择的Qt版本系列下（例如 Qt 6.5.3），勾选你需要的版本。对于新手，选择最新的 LTS 版本 是明智的。只勾选你需要的那个版本即可。
      • 选择编译器/平台变体 (重点！)： 这是很多新手困惑的地方。同一个Qt版本（如Qt 6.5.3）可能会有多个变体，它们是针对不同的编译器或开发环境构建的。你需要选择一个与你系统环境兼容且你打算使用的编译器。
        • Windows用户：
          • MinGW <version>: 使用MinGW编译器。Qt安装器通常会捆绑一个MinGW编译器，安装过程比较简单，适合新手入门。如果你不打算使用Visual Studio，这是个不错的选择。
          • MSVC <version> <architecture>: 使用Microsoft Visual C++ (MSVC) 编译器。如果你已经安装了Visual Studio (推荐使用VS 2019 或更新版本，并确保安装了C++开发组件)，或者打算用MSVC进行开发，就选择这个。你需要确保系统中已经安装了对应的Visual Studio版本和C++桌面开发工作负载。通常有x86 (32位) 和 x64 (64位) 两种架构可选，选择x64是主流趋势。
          • UWP <version>: 用于开发Windows Universal Platform (UWP) 应用，一般新手用不到。
          • Android, WebAssembly: 用于跨平台开发到Android或Web，如果你目前只关注桌面开发，暂时不要选择。
          • 新手推荐（Windows）： 如果你没有安装Visual Studio或不打算使用MSVC，勾选带 MinGW 字样的变体。安装器会自动帮你安装配套的MinGW编译器。如果你的Visual Studio环境配置良好，选择对应的 MSVC x64 变体 也是可以的。通常，MinGW对于新手来说配置更简单。
        • macOS用户：
          • 通常只有一个或少数几个变体，基于macOS内置的Clang编译器。选择对应的版本即可。你需要确保你的macOS系统安装了Command Line Tools for Xcode 或完整的Xcode，它们提供了Clang编译器。
        • Linux用户：
          • 通常是基于GCC或Clang编译器。选择对应的变体即可。你需要确保你的Linux系统安装了基本的构建工具链（build-essential），包括GCC/G++或Clang。
        • 总结编译器选择： 选择一个你系统中有对应编译器，或者安装器能为你安装配套编译器的变体。对于Windows新手，MinGW通常是最简单的入门选择。对于macOS和Linux，确保系统已安装GCC/Clang构建工具。
      • 附加组件 (Add-on Components): 在每个Qt版本变体下，有很多可选的模块，如Charts (图表), Data Visualization (数据可视化), Multimedia (多媒体), NetworkAuth (网络认证) 等。这些是Qt提供的额外功能。
        • 新手建议： 第一次安装时，为了节省空间和时间，可以只勾选核心的组件。通常核心组件是默认勾选的，它们构成了Qt的基础功能。除非你明确知道你的项目需要某个特定的附加组件，否则可以暂时不勾选它们。你可以在以后需要时，再次运行安装器来添加这些组件。
      • Developer and Designer Tools (开发者和设计工具) (重点！): 这一项通常在组件列表的底部，它包含了开发Qt应用程序必不可少的工具。
        • Qt Creator : 强烈推荐勾选！ 这是Qt官方的集成开发环境（IDE），功能强大且为Qt开发量身定制，集成了代码编辑、UI设计（Qt Designer）、项目管理、构建、调试等功能。几乎所有Qt开发者都使用它。务必勾选 Qt Creator！
        • CMake <version>: CMake是一个跨平台的构建系统，Qt项目广泛使用CMake进行构建。安装器提供的CMake版本通常与Qt Creator兼容。建议勾选。
        • Debugging Tools <version>: 调试工具，对于程序调试非常重要。在Windows上可能是基于MinGW GDB或MSVC调试器。建议勾选。
        • Qt Design Studio <version>: 用于设计Qt Quick/QML界面的专业设计工具，功能比Qt Creator内置的Designer更强大。新手入门时可以暂时不安装，等熟悉Qt Quick/QML后再考虑。
        • Documentation <version>: Qt的官方文档。非常重要，但体积可能较大。你可以选择在线查阅文档，或者勾选下载离线文档。新手可以先依赖在线文档。
        • Examples <version>: 大量的Qt示例代码。学习Qt的绝佳资源！强烈推荐勾选！ 通过研究示例代码，你可以快速学习Qt的各种功能用法。体积可能较大，但物超所值。
        • Source Components <version>: Qt的源代码。如果你需要研究Qt底层代码或进行深度定制，可以选择。通常新手不需要安装源代码，体积也非常大。
      • 总结新手推荐勾选项：
        1. 一个最新的Qt LTS版本（如 Qt 6.5.3）。
        2. 该版本下与你系统兼容且易于配置的一个编译器变体 (Windows推荐MinGW，macOS/Linux选择默认的Clang/GCC变体)。
        3. Developer and Designer Tools 下的 Qt Creator。
        4. Developer and Designer Tools 下的 CMake。
        5. Developer and Designer Tools 下的 Debugging Tools。
        6. Developer and Designer Tools 下的 Examples。

    • 当你勾选或取消勾选组件时，界面下方会显示估计的下载大小和安装所需的硬盘空间。请留意这个数字，确保你有足够的空间。

    • 选择完毕后，点击“Next”。

  6. Qt Company Privacy Policy / 隐私政策：

    • 阅读并接受Qt的隐私政策。勾选同意。
    • 点击“Next”。

  7. Ready to Install (准备安装):

    • 这个界面会显示你即将安装的所有组件列表以及安装路径。仔细检查一遍，确认无误。
    • 点击“Install”。

  8. Installation (安装过程):

    • 安装器现在会开始下载和安装你选择的组件。这个过程可能会持续一段时间，具体取决于你的网速和你选择的组件数量。进度条会显示下载和安装的进度。
    • 请保持网络连接畅通，并耐心等待。期间不要关闭安装器窗口或让电脑休眠。

  9. Installation Finished (安装完成):

    • 当所有组件下载并安装完毕后，安装器会显示“Installation Finished”或类似的提示。
    • 通常会有一些附加选项，例如 “Launch Qt Creator” (启动Qt Creator) 或 “Show ReadMe” (显示自述文件)。
    • 勾选 “Launch Qt Creator” 可以让你在安装完成后立即打开Qt的IDE，进行初步的验证。
    • 点击“Finish”退出安装器。

安装后的初步验证：确保一切就绪

安装完成后，我们来简单验证一下Qt是否安装成功。

  1. 启动Qt Creator： 如果你在安装结束时勾选了“Launch Qt Creator”，它会自动打开。否则，你可以在开始菜单（Windows）、应用程序文件夹（macOS）或系统应用列表（Linux）中找到并启动 Qt Creator。
  2. Qt Creator界面： Qt Creator首次启动可能需要一些时间来配置。你将看到Qt Creator的主界面。
  3. 检查 Kits (工具链)： 在Qt Creator中，”Kit” 代表一个完整的开发环境配置，包括Qt版本、编译器、调试器、CMake版本等。成功的安装应该至少为你自动配置好一个或多个Kit。
    • 在Qt Creator的菜单栏中，通常可以通过 Tools -> Options (或 Preferences on macOS) 进入设置界面。
    • 在左侧导航栏中找到 Kits。
    • 在 Kits 列表中，你应该能看到安装器为你配置好的Kit，例如 “Desktop Qt “. 检查这些Kit是否标记为有效（通常是一个绿色的勾）。如果显示黄色警告或红色错误，可能表示某个组件（如编译器或调试器）没有被Qt Creator正确检测到，这可能需要手动配置。但对于遵循本指南使用MinGW或系统自带编译器的新手来说，大部分情况下Qt Creator应该能自动配置好。
  4. 创建/运行示例项目： 验证安装最直观的方式是尝试打开并运行一个简单的示例项目。
    • 在Qt Creator中，选择 File -> New File or Project...。
    • 在弹出的对话框中，选择 Examples。
    • 浏览或搜索一个简单的示例，比如 “Analog Clock Example” 或 “Widgets Gallery Example”。
    • 选择一个示例，点击“Choose…”。
    • 选择一个目录来保存项目文件，点击“Next”。
    • 在 Kit Selection 步骤，确保选择了刚才验证过的有效Kit。点击“Next”。
    • 项目创建向导完成后，点击左下角的“Build” (锤子图标) 按钮来编译项目，然后点击“Run” (绿色播放按钮) 按钮来运行项目。
    • 如果示例项目能够成功编译和运行，并显示出窗口界面，那么恭喜你，Qt开发环境已经成功安装并配置好了！

常见问题与疑难解答

即使按照步骤操作，新手也可能遇到一些问题。这里列出一些常见的安装问题及其可能的解决方案：

  1. 安装器下载速度慢或中断：
    • 原因： 网络问题，或者Qt下载服务器繁忙。
    • 解决方案： 检查你的网络连接。尝试更换网络环境（例如，从Wi-Fi切换到有线连接）。如果长时间速度很慢，可能是服务器问题，可以稍后再尝试下载。如果经常中断，考虑使用离线安装器（但离线安装器体积很大）。
  2. 安装过程中卡住不动：
    • 原因： 网络连接问题、磁盘读写问题、安全软件（防火墙/杀毒软件）阻止。
    • 解决方案： 检查网络连接是否中断。查看安装目录所在的硬盘是否有异常活动。暂时关闭防火墙或杀毒软件（安装完成后请重新开启）。如果问题依然存在，尝试重新运行安装器。
  3. Qt Creator启动后显示 Kit 无效/找不到编译器：
    • 原因： 你选择了某个编译器变体，但系统中没有找到对应的编译器，或者Qt Creator没有检测到它。例如，选择了MSVC变体但没有安装Visual Studio C++组件，或者安装了MinGW但路径配置有问题。
    • 解决方案：
      • MinGW： 如果安装时选择了MinGW变体，安装器应该会自动安装MinGW。检查Qt安装目录下的MinGW文件夹是否存在。如果不存在，重新运行安装器，确保勾选了MinGW组件。如果存在，但在Qt Creator中无效，可能需要手动在 Tools -> Options -> Kits -> Compilers 中添加MinGW的g++.exe路径。
      • MSVC： 如果安装时选择了MSVC变体，你需要确保已经安装了对应版本的Visual Studio，并且在Visual Studio安装时勾选了“使用C++的桌面开发”工作负载。安装或修复Visual Studio后，重启Qt Creator看是否能自动检测到。如果不能，可能需要手动在 Tools -> Options -> Kits -> Compilers 中添加MSVC的编译器路径。
      • macOS/Linux (Clang/GCC)： 确保你的系统安装了必要的构建工具链（build-essential 在Ubuntu上，Xcode Command Line Tools 或 Xcode 在macOS上）。在终端运行 gcc --version 或 clang --version 看是否有输出。如果没有，需要安装。
    • 大多数情况下，对于新手推荐的MinGW或系统自带编译器，Qt Creator应该能自动配置好Kit。如果遇到问题，可以搜索具体的错误信息，或者查阅Qt官方文档关于Kit配置的部分。
  4. 硬盘空间不足：
    • 原因： 选择安装的组件太多，或者安装目录所在分区空间不足。
    • 解决方案： 在安装前或安装过程中查看所需的硬盘空间，并确保目标分区有足够余量。如果空间不足，取消勾选一些非必要的组件（如附加模块、示例、文档、源代码），只保留核心组件、Qt Creator和一套编译器。你可以在以后空间充足时再添加其他组件。
  5. 登录Qt账户失败：
    • 原因： 账户或密码错误，网络问题，防火墙阻止。
    • 解决方案： 仔细检查输入的邮箱和密码是否正确，注意大小写。确认网络连接正常。临时关闭防火墙或杀毒软件。如果忘记密码，使用“Forgot password”功能重置。
  6. 安装完成后无法启动Qt Creator：
    • 原因： 安装不完整、文件损坏、系统环境变量问题、安全软件阻止。
    • 解决方案： 尝试重新启动电脑。检查Qt安装目录下的Qt Creator可执行文件是否存在。如果不存在，尝试重新运行安装器进行修复或重新安装。检查系统环境变量PATH中是否包含了Qt Creator的bin目录（通常不需要手动设置，但有时可能是原因）。检查杀毒软件隔离区是否有Qt Creator相关文件。

恭喜你！迈出下一步

走到这里，你已经成功地下载并安装了Qt开发环境，并进行了初步的验证。这代表你已经迈出了学习Qt编程的坚实一步！

接下来，不要犹豫，打开Qt Creator，开始你的探索之旅吧。

  • 浏览示例： 尝试打开并运行更多你感兴趣的示例项目。通过阅读示例代码，你可以学习到Qt各种功能的使用方法。
  • 创建你的第一个项目： 尝试使用Qt Creator创建一个简单的项目，比如一个HelloWorld窗口程序。这能帮助你熟悉Qt Creator的开发流程。
  • 查阅文档： Qt官方文档非常全面。遇到任何问题或想了解某个类/函数的用法，都可以查阅文档。
  • 寻找教程： 网络上有大量的Qt入门教程（文字、视频），跟随教程一步步学习基本概念和常用控件。

总结

Qt的安装过程对于新手来说可能略显繁琐，特别是选择组件这一步。但只要你按照本指南，明确知道每一步的目的，并按照推荐配置进行选择，整个过程就会变得可控且容易。

记住关键点：选择最新的Qt LTS开源版本，使用在线安装器，在组件选择时务必勾选 Qt Creator、一个合适的 编译器变体、以及可选的 Examples 和 Debugging Tools。

现在，你的电脑已经拥有了强大的Qt开发能力。祝你在Qt编程的世界里探索愉快，创造出属于你自己的精彩应用！

发表评论

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

滚动至顶部