如何下载并安装 Qt：完整图文教程 – wiki基地

作者： /

文章标题：Qt 从零到一：超详细下载与安装图文完整教程 (Windows 平台)

摘要： Qt 是一个功能强大且广泛应用的跨平台 C++ 图形用户界面应用程序开发框架。无论您是初学者还是有经验的开发者，想要踏入 Qt 开发的大门，首先需要正确地下载和安装 Qt。本教程将手把手带您完成 Qt 的下载、安装以及初步配置的全过程，并配以详细的图文说明，确保您能顺利搭建起 Qt 开发环境。

字数： 约 3500 字

目录：

  1. 引言：为什么选择 Qt？
    • Qt 的核心优势
    • 本教程的目标读者与前提条件
  2. 第一部分：下载 Qt Online Installer
    • 理解 Qt 的授权模式（开源与商业）
    • 访问 Qt 官方网站
    • 注册 Qt Account（必要步骤）
    • 下载 Qt Online Installer
  3. 第二部分：安装 Qt
    • 运行 Qt Online Installer
    • 登录 Qt Account
    • 阅读并接受开源义务（若选择开源版本）
    • 设置安装目录
    • 选择安装类型（自定义安装详解）
      • 选择 Qt 版本 (如 Qt 6.x, Qt 5.x)
      • 选择模块 (如 Core, GUI, Widgets, Quick, Network 等)
      • 选择工具 (Qt Creator, Design Tools, Maintenance Tool)
      • 选择开发工具和编译器 (MinGW, MSVC, Android SDK/NDK 等)
    • 同意许可协议
    • 开始安装与等待
    • 安装完成
  4. 第三部分：安装后验证与初步配置
    • 启动 Qt Creator
    • 理解 Kits (构建套件)
    • 创建一个简单的 “Hello World” 项目
      • 选择项目模板
      • 配置项目名称和路径
      • 选择构建系统 (qmake, CMake)
      • 选择 Kit
      • 版本控制 (可选)
    • 编写简单代码
    • 构建并运行项目
  5. 第四部分：常见问题与维护
    • 网络问题导致下载/安装失败
    • 磁盘空间不足
    • 如何添加/删除组件或更新 Qt (使用 Maintenance Tool)
    • 环境变量配置 (通常 Qt Creator 会处理)
  6. 结语：开启您的 Qt 之旅

1. 引言：为什么选择 Qt？

Qt (发音为 “cute”) 是一款全球知名的跨平台应用程序开发框架，广泛用于开发图形用户界面 (GUI) 程序，也可用于开发非 GUI 程序，如控制台工具和服务器。它使用标准的 C++，并对其进行了扩展，引入了信号与槽机制、元对象系统等，极大地简化了复杂应用的开发。

  • Qt 的核心优势：

    • 跨平台性： 一套代码，多平台编译运行（Windows, macOS, Linux, Android, iOS, 嵌入式系统等）。
    • 丰富的 API： 提供了涵盖网络、数据库、多媒体、XML、JSON、图形渲染等众多领域的模块。
    • 强大的 IDE： Qt Creator 是一款专为 Qt 开发设计的集成开发环境，功能完善。
    • 优秀的文档与社区： 官方文档详尽，社区活跃，遇到问题容易找到解决方案。
    • 面向对象： 基于 C++，充分利用面向对象的特性。
    • 美观的界面： Qt Quick (QML) 使得创建现代化、流畅的用户界面变得更加容易。

  • 本教程的目标读者与前提条件：

    • 目标读者： 希望学习 Qt 开发的初学者、学生、C++ 开发者以及任何对跨平台 GUI 开发感兴趣的人员。
    • 前提条件：
      • 一台运行 Windows 操作系统的计算机（本教程以 Windows 10/11 为例，Linux 和 macOS 过程类似）。
      • 基本的计算机操作能力。
      • 对 C++ 语言有初步了解会更有帮助，但不是强制性的（可以边学 Qt 边补 C++）。
      • 稳定的网络连接（Qt 安装包较大）。

2. 第一部分：下载 Qt Online Installer

Qt 提供了在线安装器 (Online Installer) 和离线安装包 (Offline Installer)。在线安装器体积小，可以根据您的选择下载所需组件，更加灵活，是官方推荐的方式。

  • 理解 Qt 的授权模式：

    • 开源许可 (LGPL/GPL)： 对于开源项目和符合特定条件的应用，可以免费使用 Qt。您需要遵守相应的开源协议。
    • 商业许可： 如果您开发闭源商业应用，或者需要官方技术支持、特定商业组件，则需要购买商业许可。
    • 本教程将基于开源许可进行安装。

  • 访问 Qt 官方网站：
    打开您的浏览器，访问 Qt 官方网站：https://www.qt.io/

    [截图：Qt 官方网站首页]

  • 注册 Qt Account（必要步骤）：
    从 Qt 5.15/Qt 6 开始，使用在线安装器需要一个 Qt Account。

    1. 在官网首页，通常右上角会有 “Login” 或 “Account” 的链接，点击进入。
    2. 如果您已有账户，直接登录。如果没有，点击 “Create Qt Account” 或类似按钮。
      [截图：Qt 登录/注册页面]
    3. 填写注册信息：邮箱、密码、国家等。请务必使用有效邮箱，因为需要验证。
      [截图：填写 Qt Account 注册信息表单]
    4. 同意相关条款，完成注册，并前往您的邮箱激活账户。

  • 下载 Qt Online Installer：

    1. 登录 Qt Account 后，在官网寻找 “Download”、”Download Qt” 或 “Get started” 等相关链接。通常，它会引导您到一个专门的下载页面。
    2. 在下载页面，您会看到不同平台的下载选项。找到 “Qt Online Installer”。
      [截图：Qt 下载页面，高亮显示 Online Installer]
    3. 点击对应您操作系统的 Online Installer 下载链接（例如 “Qt Online Installer for Windows”）。
    4. 下载器文件通常不大 (几十MB)，很快就能下载完成。默认文件名可能是 qt-unified-windows-x64-online.exe (版本号可能会不同)。

3. 第二部分：安装 Qt

下载完成后，就可以开始安装 Qt 了。

  • 运行 Qt Online Installer：
    找到您下载的 .exe 文件，双击运行。Windows 可能会弹出用户账户控制 (UAC) 提示，点击 “是”。

    [截图：Windows UAC 提示]

  • 登录 Qt Account：
    安装程序启动后，首先会要求您登录 Qt Account。输入您之前注册的邮箱和密码。

    [截图：Qt Installer 登录界面]
    勾选 “我已阅读并同意…” 选项，然后点击 “下一步”。

  • 阅读并接受开源义务（若选择开源版本）：
    如果您打算使用开源版本，这里会显示 Qt 开源使用义务的说明。请仔细阅读，理解作为开源用户需要承担的责任（例如，若动态链接 Qt 库，需遵守 LGPL；若修改 Qt 源码并分发，需遵守 GPL/LGPL 等）。
    勾选 “我已阅读并同意 Qt 开源用户义务…” 和（如果适用）”我是个人用户…” 或 “我代表公司…”。

    [截图：Qt 开源义务说明页面]
    点击 “下一步”。

  • 设置安装目录：
    选择您希望将 Qt 安装到的路径。建议不要安装在包含中文或空格的路径下，以免后续开发中遇到不必要的麻烦。默认路径通常是 C:\Qt。您可以根据自己的磁盘空间和习惯进行修改。
    同时，这里会有一个选项 “Associate common file types with Qt Creator”，建议勾选，这样 .pro, .qml 等文件会默认用 Qt Creator 打开。

    [截图：Qt 安装目录选择页面]
    点击 “下一步”。

  • 选择安装类型（自定义安装详解）：
    这是最关键的一步。推荐选择 “Custom installation” (自定义安装)，这样您可以精确控制安装哪些组件。

    [截图：Qt 安装类型选择页面，高亮 “Custom installation”]
    点击 “下一步” 后，您会看到一个组件选择树。这里的内容非常丰富，我们来详细解析：

    • Qt 版本 (如 Qt 6.x, Qt 5.x):

      • Qt 6.x (例如 Qt 6.5.0, Qt 6.2.4 LTS): 最新主版本系列，包含最新的功能和改进，但可能对一些旧项目的兼容性需要调整。LTS (Long Term Support) 版本表示长期支持版，更稳定，适合商业项目。
      • Qt 5.x (例如 Qt 5.15.2 LTS): 曾经的主流版本，非常成熟稳定，拥有庞大的社区和项目基础。如果您的项目依赖于某些 Qt 6 尚未完全支持或行为有变的模块，或者您需要更广泛的第三方库兼容性，可以选择 Qt 5.15 LTS。
      • 选择建议： 如果是新项目且没有特殊依赖，推荐选择最新的 Qt 6 LTS 版本。如果需要维护旧项目或有特定需求，可以选择 Qt 5.15 LTS。您可以同时安装多个 Qt 版本。

      [截图：Qt 组件选择树 – Qt 版本部分，例如展开 Qt 6.5]

    • 选择模块 (在特定 Qt 版本下):
      展开您选择的 Qt 版本 (例如 Qt 6.5.0)，您会看到具体的模块。

      • MinGW x.x.x (例如 MinGW 11.2.0 64-bit): 这是 Windows 平台下 GCC 编译器的移植版。如果您没有安装 Visual Studio，或者希望使用 GCC 工具链，务必勾选一个 MinGW 版本。强烈推荐至少勾选一个 MinGW 版本，它是最方便的入门选择。
      • MSVC xxxx (例如 MSVC 2019 64-bit): 如果您安装了对应版本的 Microsoft Visual Studio，并希望使用其编译器 (CL.exe)，可以勾选此项。注意，您需要预先安装好 Visual Studio Community/Professional/Enterprise 版，并确保安装了 “使用 C++ 的桌面开发” 工作负载。
      • Android ARMv7/ARM64-v8a/x86/x86_64: 如果您计划进行 Android 开发，需要勾选相应的 Android 架构。这通常还需要您后续配置 Android SDK 和 NDK。
      • Sources: Qt 源代码。如果您想调试 Qt 内部或编译 Qt，可以勾选。对于初学者，通常不需要。
      • Qt : 如 Qt Charts, Qt Data Visualization, Qt Network Authorization, Qt WebEngine 等。这些是 Qt 的附加模块，按需勾选。初学者可以暂时不选，以后需要时可以通过 Maintenance Tool 添加。Qt WebEngine 模块比较大，如果暂时用不到可以不选。
      • 注意： 核心模块 (如 Core, GUI, Widgets, Network, Quick Controls) 通常是默认包含在您选择的编译器目标 (如 MinGW) 下的，不需要单独在模块列表里找。

      [截图：Qt 组件选择树 – 展开某个 Qt 版本后的模块，高亮 MinGW 和 MSVC 选项]

    • 选择工具 (Developer and Designer Tools):
      展开 “Developer and Designer Tools” 类别。

      • Qt Creator x.x.x: 这是 Qt 的官方集成开发环境 (IDE)。强烈建议勾选最新版本。
      • Qt Design Studio x.x.x: 一款专注于 UI/UX 设计的工具，特别是针对 Qt Quick (QML) 的可视化设计。如果您主要做 QML 界面设计，可以考虑。初学者可以不选。
      • CMake x.x.x: Qt Creator 支持 CMake 构建系统，这里提供了一个捆绑的 CMake 版本。如果您不确定，可以勾选。
      • Ninja: 一个快速的构建系统，常与 CMake 配合使用。勾选。
      • OpenSSL x.x.x Toolkit: 如果您的应用需要 SSL/TLS 功能 (例如 HTTPS)，需要勾选 OpenSSL。推荐勾选一个。

      [截图：Qt 组件选择树 – Developer and Designer Tools 部分，高亮 Qt Creator 和 MinGW]

    • 选择开发工具和编译器 (简要回顾):
      再次确认您至少选择了一个编译器套件。对于 Windows 初学者，最简单的是只选择一个 MinGW 版本（例如，在 Qt 6.5.0 下勾选 MinGW 11.2.0 64-bit）。这将安装 Qt 库本身 (针对 MinGW 编译) 和 MinGW 工具链。
      如果您有 Visual Studio 2019 或更高版本，并安装了 C++桌面开发组件，也可以勾选对应的 MSVC 编译器选项（例如，在 Qt 6.5.0 下勾选 MSVC 2019 64-bit）。

      新手推荐组合：
      * 最新的 Qt LTS 版本 (如 Qt 6.5.0)
      * MinGW (最新版，64位)
      * Developer and Designer Tools
      * Qt Creator (最新版)
      * CMake (可选，但推荐)
      * Ninja

      [截图：一个推荐的组件选择最终状态示例]

    选择完毕后，点击 “下一步”。

  • 同意许可协议：
    您需要同意所选组件的许可协议。仔细阅读（特别是第三方库的许可），然后勾选 “I have read and agree to the terms and conditions of the license agreements…”。

    [截图：Qt 许可协议同意页面]
    点击 “下一步”。

  • 开始安装与等待：
    安装程序会显示一个准备安装的摘要。确认无误后，点击 “Install”。
    Qt 安装程序会开始下载并安装您选择的组件。这个过程可能需要较长时间，具体取决于您的网络速度和所选组件的大小 (通常几 GB 到十几 GB)。请耐心等待。

    [截图：Qt 安装进度条页面]

  • 安装完成：
    安装完成后，会显示 “Installation finished successfully.” 的消息。您可以勾选 “Launch Qt Creator” 以便立即启动它。

    [截图：Qt 安装完成页面]
    点击 “Finish”。

4. 第三部分：安装后验证与初步配置

  • 启动 Qt Creator：
    如果上一步没有勾选 “Launch Qt Creator”，您可以从开始菜单找到并启动 Qt Creator。

    [截图：Windows 开始菜单中的 Qt Creator 图标]
    首次启动 Qt Creator 可能需要一些初始配置时间。

  • 理解 Kits (构建套件)：
    Kit 是 Qt Creator 中一个非常重要的概念。一个 Kit 定义了一套完整的构建和运行 Qt 应用所需的环境，包括：

    • Qt 版本 (例如 Qt 6.5.0 MinGW)
    • 编译器 (例如 MinGW GCC/G++, MSVC CL.exe)
    • 调试器 (例如 GDB, CDB)
    • 设备类型 (例如 Desktop, Android)
    • CMake 工具 (如果使用 CMake)

    Qt Creator 通常会自动检测您安装的 Qt 版本和编译器，并尝试自动配置 Kits。
    您可以在 Qt Creator 的 “工具 (Tools)” -> “选项 (Options)” -> “Kits” (或在较新版本中是 “构建和运行 (Build & Run)” -> “Kits”) 中查看和管理 Kits。

    [截图：Qt Creator 的 Kits 配置界面，显示自动检测到的 Kit]
    确保至少有一个 Kit 是被正确识别并处于可用状态（通常是绿色的勾）。如果 Kit 前面有黄色感叹号，可能表示缺少某些配置（如调试器未正确设置），但通常对于 MinGW 来说，默认配置即可工作。

  • 创建一个简单的 “Hello World” 项目：
    让我们创建一个简单的项目来验证安装是否成功。

    1. 在 Qt Creator 欢迎界面，点击 “New Project” 或 “+新建项目”，或者通过菜单 “文件 (File)” -> “新建文件或项目 (New File or Project…)”。

      [截图：Qt Creator 欢迎界面，高亮 “New Project”]
      2. 选择项目模板：
      在弹出的对话框中，选择 “Application (Qt)” -> “Qt Widgets Application” (这是一个经典的桌面应用模板)。点击 “Choose…”。

      [截图：Qt Creator 新建项目 – 选择模板页面]
      3. 配置项目名称和路径：
      * 名称 (Name): 输入项目名称，例如 HelloWorld。
      * 创建路径 (Create in): 选择项目存放的路径。同样，避免中文或空格。
      * Qt Creator 会自动生成项目文件夹。

      [截图：Qt Creator 新建项目 – 项目名称和路径配置]
      点击 “下一步 (Next)”。
      4. 选择构建系统 (Build system):
      您可以选择 qmake 或 CMake。qmake 是 Qt 传统的构建系统，简单易用。CMake 是一个更通用、更强大的构建系统。对于初学者，qmake 更容易上手。选择 qmake。

      [截图：Qt Creator 新建项目 – 选择构建系统页面]
      点击 “下一步 (Next)”。
      5. 类信息 (Class Information):
      这里可以设置主窗口类的名称 (默认为 MainWindow)、基类 (默认为 QMainWindow) 等。保持默认即可。
      勾选 “Generate form” 会创建一个 .ui 文件，用于通过 Qt Designer 可视化设计界面。

      [截图：Qt Creator 新建项目 – 类信息配置]
      点击 “下一步 (Next)”。
      6. 翻译文件 (Translation File):
      如果您需要多语言支持，可以在这里添加。暂时保持默认 “None”。
      点击 “下一步 (Next)”。
      7. 选择 Kit：
      这里会列出您系统中可用的 Kits。选择一个您之前确认配置正确的 Kit (例如，包含 MinGW 的那个 Kit)。如果您安装了多个 Kit，确保选择的是您想用来编译这个项目的。

      [截图：Qt Creator 新建项目 – Kit 选择页面]
      点击 “下一步 (Next)”。
      8. 版本控制 (Version Control):
      如果您想将项目添加到版本控制系统 (如 Git)，可以在这里设置。暂时选择 “None”。
      点击 “Finish”。

  • 编写简单代码：
    项目创建完成后，Qt Creator 会自动打开项目文件。

    1. 在左侧的项目树中，展开 “Sources”，双击 main.cpp。这是程序的入口点。

    2. 展开 “Forms”，双击 mainwindow.ui。这会打开 Qt Designer 界面。

      • 从左侧的 “Widget Box” (控件盒) 中拖拽一个 “Label” (标签) 到主窗口的中央。
      • 在右下角的 “Property Editor” (属性编辑器) 中，找到 text 属性，将其值修改为 “Hello, Qt World!”。
      • 找到 objectName 属性，确保它有一个名字，比如 label。

      [截图：Qt Designer 界面，拖拽 Label 并修改文本]
      3. 保存 .ui 文件 (Ctrl+S)。
      4. （可选）如果您想通过代码设置文本，可以打开 mainwindow.cpp，在构造函数 MainWindow::MainWindow(QWidget *parent) 中，ui->setupUi(this); 之后添加：
      cpp
      ui->label->setText("Hello, Qt World! (From Code)");
      这行代码会找到名为 label 的 UI 元素并设置其文本。

  • 构建并运行项目：

    1. 点击 Qt Creator 左下角的绿色三角形 “运行 (Run)” 按钮（或按 Ctrl+R）。
      [截图：Qt Creator 左下角的运行、调试、构建按钮]
    2. Qt Creator 会首先构建项目 (编译、链接)，然后在下方 “应用程序输出” 栏显示构建过程。
    3. 如果没有错误，程序会运行起来，弹出一个包含 “Hello, Qt World!” 文本的窗口。

    [截图：运行成功的 HelloWorld Qt 程序窗口]

    恭喜！您已成功安装 Qt 并运行了第一个 Qt 程序。

5. 第四部分：常见问题与维护

  • 网络问题导致下载/安装失败：

    • 确保您的网络连接稳定。
    • 尝试更换网络环境 (例如，使用不同的 Wi-Fi 或有线连接)。
    • 检查防火墙或杀毒软件是否阻止了 Qt Installer 的网络访问。
    • 在 Qt Installer 登录后的某个步骤 (通常是欢迎页面或设置代理页面)，可以设置代理服务器。

  • 磁盘空间不足：
    Qt 完整安装可能需要 10-30GB 或更多的磁盘空间，取决于您选择的组件。确保安装目录所在磁盘有足够空间。

  • 如何添加/删除组件或更新 Qt (使用 Maintenance Tool)：
    Qt 安装完成后，在您的 Qt 安装目录 (例如 C:\Qt) 下会有一个 MaintenanceTool.exe。运行它。
    [截图：MaintenanceTool.exe 在 Qt 安装目录中的位置]
    使用您的 Qt Account 登录后，您可以：

    • Add or remove components: 添加之前未安装的 Qt 版本、模块或工具，或者卸载不再需要的组件。
    • Update components: 检查并安装已安装组件的更新。
    • Uninstall all: 卸载整个 Qt 安装。

    [截图：Qt Maintenance Tool 主界面]

  • 环境变量配置 (通常 Qt Creator 会处理)：
    一般情况下，当您通过 Qt Creator 构建和运行项目时，Qt Creator 会自动为项目设置正确的环境变量 (如 PATH，以便找到编译器和 Qt 库)。
    如果您需要在命令行中手动编译 Qt 程序 (例如使用 qmake 和 mingw32-make)，则可能需要手动将 Qt 的 bin 目录和编译器 (如 MinGW 的 bin 目录) 添加到系统的 PATH 环境变量中。
    例如，如果您的 Qt 6.5.0 MinGW 安装在 C:\Qt\6.5.0\mingw_64\bin，MinGW 工具链在 C:\Qt\Tools\mingw1120_64\bin，则需要将这两个路径添加到 PATH。

6. 结语：开启您的 Qt 之旅

通过本教程，您应该已经成功下载、安装并初步配置好了 Qt 开发环境，并且运行了您的第一个 Qt 程序。这只是 Qt 世界的起点。Qt 的功能远不止于此，它拥有庞大的类库和无限的可能性等待您去探索。

接下来，您可以：
* 深入学习 Qt Creator 的使用。
* 系统学习 Qt 的核心概念：信号与槽、元对象系统、布局管理、事件处理等。
* 探索 Qt Widgets (传统桌面 UI) 和 Qt Quick/QML (现代化流体 UI) 的开发。
* 查阅 Qt 官方文档 (非常优秀)：https://doc.qt.io/
* 参与 Qt 社区论坛，与其他开发者交流。

祝您在 Qt 开发的道路上一切顺利，创造出色的应用程序！

希望这篇详尽的教程能帮助您顺利入门 Qt！由于无法直接插入图片，请您在实际操作时，根据文字描述对应界面上的元素。

发表评论

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

滚动至顶部