Qt 下载：安装、配置及使用入门 – wiki大全

作者： /

Qt 下载：安装、配置及使用入门

Qt 是一个功能强大的跨平台应用程序开发框架，广泛用于创建图形用户界面 (GUI) 应用程序，支持 Windows、macOS 和 Linux 等多种操作系统。本文将详细介绍 Qt 的下载、安装、配置过程以及如何开始使用。

1. 下载 Qt 在线安装程序

安装 Qt 的推荐方法是使用官方的 Qt 在线安装程序。

  1. 访问官方下载页面: 前往 Qt 官方下载页面：https://www.qt.io/download-qt-installer。
  2. 自动检测并下载: 网站通常会自动检测您的操作系统并提供相应的安装程序。下载适用于您系统的可执行文件（例如，Windows 系统为 qt-unified-windows-x64-online.exe，macOS 系统为 qt-online-installer-macOS.dmg，Linux 系统为 qt-unified-linux-x64-online.run）。
  3. 创建或登录 Qt 账户: 在安装过程中，您需要创建或登录一个 Qt 账户。对于开源用户，请注册为个人用户，而非商业用途。

2. 运行安装程序并选择组件

安装过程涉及多个步骤，其中最关键的是选择您希望安装的组件。

一般步骤：

  1. 运行安装程序: 双击下载的安装程序文件。
  2. 遵循屏幕提示: 阅读并同意许可条款。
  3. 登录 Qt 账户: 使用您的 Qt 账户登录。
  4. 选择安装文件夹: 建议选择默认的安装路径。

组件选择（关键步骤）：

在此步骤中，您将选择特定的 Qt 版本和开发工具。

  • Qt 版本: 展开 “Qt” 部分，选择您想要的 Qt 版本（例如，Qt 6.x.x）。
  • 编译器工具链: 在选定的 Qt 版本下，为您的系统选择合适的编译器工具链：
    • Windows: 选择 MinGW 工具链（例如 MinGW 11.2.0 64-bit），或者如果您打算与 Visual Studio 集成，可以选择 MSVC 工具链。
    • macOS: 安装程序通常会处理 macOS 特定的组件。请确保您已安装 Xcode 命令行工具。您可以在终端中运行 xcode-select --install 来安装它们。
    • Linux: 安装程序假定您已安装 C++ 编译器、调试器和 make。在运行 Qt 安装程序之前，请确保通过包管理器安装了开发工具，例如（对于基于 Debian/Ubuntu 的系统）build-essential 和 libgl1-mesa-dev。
  • Qt Creator: 确保选中 “Qt Creator”，它是 Qt 开发的集成开发环境 (IDE)。
  • 其他工具: 如果在 Windows 上，您可能还需要选择 “Debugging Tools for Windows”。

Linux 特定的执行方式：

在 Linux 上，下载安装程序后，您可能需要使其可执行：

  1. 打开终端。
  2. 导航到下载目录: 例如，cd ~/Downloads。
  3. 赋予执行权限: chmod +x qt-unified-linux-x64-online.run (请替换为您的安装程序文件名)。
  4. 运行安装程序: ./qt-unified-linux-x64-online.run。

3. 配置环境变量 (可选/高级)

对于大多数用户，Qt Creator 会自动为您的项目配置必要的环境。但是，如果您需要从命令行使用 Qt 工具或与其它 IDE 集成，您可能需要设置系统级的环境变量。

常见的环境变量包括：

  • QTDIR: 指向您的 Qt 安装目录。
  • PATH: 将您的 Qt 安装目录下的 bin 目录添加到系统 PATH 变量中，以便您可以在任何终端中运行 qmake 等 Qt 工具。
  • LD_LIBRARY_PATH (Linux): 指定搜索共享库的目录。
  • MANPATH: 用于 Qt 手册页。

Linux 示例 (添加到 ~/.bashrc 或 ~/.profile):

bash
export QTDIR=/path/to/your/Qt/installation/version_number/gcc_64
export PATH=$QTDIR/bin:$PATH
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH

在 Qt Creator 中配置环境变量:

Qt Creator 允许您专门为构建或运行配置设置环境变量，可以是针对某个 Kit 全局设置，也可以是针对每个项目进行设置。

  1. 进入 Preferences (或 macOS 上的 Qt Creator > Preferences) > Build & Run > Kits。
  2. 选择您正在使用的 Kit。
  3. 在 “Environment” 部分，点击 “Change” 来添加或修改变量。

4. 验证安装

要验证 Qt 和 qmake 是否正确安装并可访问：

  1. 打开终端或命令提示符。
  2. 输入 qmake --version 并按 Enter。

如果安装成功，您应该会看到显示 qmake 版本及其使用的 Qt 版本的输出。

5. 创建您的第一个项目（入门）

  1. 启动 Qt Creator。
  2. 从欢迎界面选择 “New Project” 或通过 File > New File or Project。
  3. 选择一个项目模板（例如 “Qt Widgets Application” 或 “Qt Quick Application”）。
  4. 按照向导为您的项目命名、选择位置并选择已安装的 Qt Kit。
  5. 构建并运行默认项目，以确保一切正常工作。

通过以上步骤，您应该已经成功安装并配置了 Qt 开发环境，并准备好开始创建您的第一个 Qt 应用程序。

滚动至顶部