Qt 6.5安装与配置教程：轻松开启跨平台开发之旅 – wiki基地

作者： /

我明白了，之前的工具无法使用。在这种情况下，我无法将文章直接保存为文件。因此，我将直接在这里展示为您生成的完整的教程内容。您可以手动复制并将其保存到您喜欢的编辑器中。

Qt 6.5 安装与配置教程：轻松开启跨平台开发之旅

前言

Qt 是一个功能强大且广受欢迎的 C++ 跨平台应用程序开发框架。无论您是想开发桌面应用、移动应用还是嵌入式系统，Qt 都能提供一套统一、高效的解决方案。最新的 Qt 6.5 版本在性能、功能和开发者体验上都带来了显著提升。本教程将手把手带您完成 Qt 6.5 的下载、安装与配置，助您顺利开启跨平台开发之旅。

一、准备工作

在开始安装之前，请确保您的系统满足基本要求，并完成必要的准备。

1. 系统要求

  • 操作系统:
    • Windows 10/11 (64-bit)
    • macOS 11 (Big Sur) 或更高版本
    • Linux (如 Ubuntu 20.04+, CentOS 7+)
  • 编译器:
    • Windows: 需要一个 C++ 编译器。您可以选择：
      • MinGW: Qt 安装程序可以自带一个 MinGW 工具链，是初学者的便捷之选。
      • Visual Studio: 如果您已安装 Visual Studio 2019 或 2022，Qt 会自动检测并集成 MSVC 编译器。
    • macOS: 需要安装 Xcode Command Line Tools。
    • Linux: 需要安装 GCC/g++ 编译器。

2. 注册 Qt 账户

Qt 的开源版本虽然免费，但在下载安装程序时需要登录一个 Qt 账户。

  • 访问 Qt 官方网站 注册一个免费账户。
  • 完成邮箱验证。请务必记住您的账户和密码，安装过程中需要使用。

二、下载 Qt Online Installer

Qt 推荐使用在线安装程序（Online Installer），它可以让您灵活选择需要安装的组件。

  1. 访问 Qt 开源下载页面。
  2. 页面可能会提示您一些商业版的信息，滚动到页面下方，找到 “Download the Qt Online Installer” 按钮。
  3. 点击下载，根据您的操作系统（Windows, macOS, Linux）选择对应的安装程序。

三、逐步安装 Qt 6.5

下载完成后，运行安装程序，按照以下步骤进行操作。

1. 登录账户

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

2. 协议与遥测

  • 同意开源使用义务 (obligations)。
  • Qt 会询问您是否愿意发送匿名的使用数据以帮助改进产品，您可以根据自己的意愿选择。

3. 选择安装目录

  • 选择一个合适的路径用于安装 Qt。建议路径中不要包含中文或空格，以避免未来可能出现的编译问题。例如，D:\Qt。

4. 选择安装组件 (最关键的一步)

这是整个安装过程中最核心的步骤。请根据您的需求仔细选择。

  • Qt Versions:

    • 在 Qt 列表下，找到并展开 Qt 6.5.x（选择最新的子版本即可，如 6.5.3）。
    • 在 Qt 6.5.x 下，您需要根据您的目标平台和编译器选择必要的模块：
      • MinGW x.x.x 64-bit: Windows 用户必选。这是 Qt 官方为 Windows 平台提供的 GCC 工具链，包含了编译器、调试器等一系列开发工具，非常方便。
      • MSVC 2019 64-bit 或 MSVC 2022 64-bit: 如果您安装了 Visual Studio 并希望使用其编译器，请勾选此项。
      • macOS: 此项会在 macOS 平台默认勾选。
      • Linux: 此项会在 Linux 平台默认勾选。
      • Additional Libraries: 根据需要选择，例如 Qt Position (定位)、Qt Bluetooth (蓝牙) 等。初学者可以暂时只选择核心模块，日后通过维护工具添加。

  • Developer and Designer Tools:

    • Qt Creator x.x.x: 强烈建议勾选。这是 Qt 官方的集成开发环境 (IDE)，集成了代码编辑、UI 设计、编译、调试等功能，非常好用。
    • CMake: 新版 Qt 默认使用 CMake 构建系统，请务必勾选最新版本的 CMake。
    • Ninja: 一个高效的构建工具，推荐勾选。

总结一下，对于 Windows 初学者，最简单的组件组合是：
– Qt 6.5.x -> MinGW x.x.x 64-bit
– Developer and Designer Tools -> Qt Creator x.x.x, CMake, Ninja

5. 同意许可协议

  • 阅读并同意相关组件的许可协议。

6. 开始安装

  • 确认安装信息后，点击 “Install” 按钮。安装程序将开始下载并安装您选择的所有组件。根据您的网络速度和所选组件的大小，此过程可能需要一些时间。

7. 完成安装

  • 安装完成后，点击 “Finish”。您可以选择立即启动 Qt Creator。

四、配置开发环境

安装完成后，通常还需要一小步配置来确保开发体验顺畅。

1. 环境变量配置 (Windows)

为了能在任何命令行终端（如 CMD 或 PowerShell）中使用 Qt 的命令（如 qmake, cmake），建议将 Qt 的工具链路径添加到系统环境变量 Path 中。

  1. 找到您的 Qt 安装路径，例如 D:\Qt。
  2. 需要添加的路径通常是：
    • MinGW 的 bin 目录: D:\Qt\Tools\mingw1120_64\bin
    • Qt 6.5.x 的 bin 目录: D:\Qt\6.5.3\mingw_64\bin
      (请根据您的实际安装路径和版本号进行调整)
  3. 操作步骤:
    • 右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
    • 在“系统变量”中找到并双击 Path。
    • 点击“新建”，将上述两个路径分别添加进去。
    • 一路点击“确定”保存。
  4. 验证: 打开一个新的 CMD 窗口，输入 g++ --version，如果能看到 MinGW 的版本信息，则说明配置成功。

2. 验证 Qt Creator 配置

Qt Creator 通常会自动检测已安装的 Qt 版本和编译器，并配置好 “构建套件” (Kit)。

  1. 启动 Qt Creator。
  2. 进入 Edit -> Preferences (或 Tools -> Options)。
  3. 在左侧选择 Kits。
  4. 您应该能看到一个或多个自动检测到的 Kit，例如 Desktop (Qt 6.5.3 MinGW 64-bit)。
  5. 点击这个 Kit，检查下方的 Compiler (编译器)、Debugger (调试器) 和 Qt version (Qt版本) 是否都已正确关联且没有报错。如果一切正常，说明您的环境已经准备就绪。

五、创建第一个 “Hello, World!” 项目

让我们通过创建一个简单的项目来验证安装是否成功。

  1. 在 Qt Creator 中，点击 File -> New Project。
  2. 选择 Application (Qt) -> Qt Widgets Application -> Choose...。
  3. 项目名称和位置: 输入项目名称（如 HelloWorld），选择一个保存路径。
  4. 构建系统: 选择 CMake (推荐) 或 qmake。
  5. Kit Selection: 选择您之前验证过的 Kit (如 Desktop (Qt 6.5.3 MinGW 64-bit)）。
  6. Details & Translation: 可以直接点击 Next 和 Finish 使用默认设置。
  7. 运行项目:
    • 项目创建后，Qt Creator 会自动生成基本的文件结构。
    • 直接点击左下角的绿色 “运行” 按钮 (或按 Ctrl+R)。
    • 如果一切顺利，编译成功后您会看到一个空白的窗口弹出。

至此，您的 Qt 6.5 开发环境已成功搭建并验证通过！

总结

本教程详细介绍了从下载、安装到配置 Qt 6.5 的全过程。核心要点在于 正确选择安装组件 和 配置好环境变量。通过创建一个简单的 “Hello, World!” 项目，我们验证了整个开发环境的有效性。现在，您已经拥有了一个强大的跨平台开发工具，可以开始探索 Qt 丰富的 API，构建属于您自己的精彩应用了！

滚动至顶部