桌面应用 / 系统课时

安装 Qt 6 与 QML 开发组件

安装 Qt 6 与 QML 开发组件

本篇解决 Qt 6 QML 桌面开发环境搭建问题。你将完成 Qt 6.11、Qt Creator、桌面编译器和 Qt Quick 组件安装,并验证开发工具链能够创建和构建 QML 项目。

学习目标

  • 了解 Qt 6 QML 开发所需的核心组件和职责
  • 完成 Qt 6.11 与 Qt Creator 开发环境安装
  • 使用 Kit 验证编译器、Qt 版本和构建链是否可用

认识 QML 开发环境组成

Qt Quick 项目并不是只依赖一个 Qt 安装包。一个可运行的 QML 桌面开发环境通常包含 Qt 库、开发工具、编译器和构建配置。

主要组件职责如下:

组件 作用
Qt 6.11 提供 Qt Quick、QML 引擎和桌面开发库
Qt Creator 创建项目、编辑代码、配置 Kit、调试运行
Desktop Kit 连接 Qt 版本、编译器和构建工具
CMake 管理项目配置和构建流程

安装时最容易遗漏的是 Desktop Kit。如果 Qt Creator 找不到匹配的 Kit,即使 Qt 已经安装,也无法正常构建项目。

安装 Qt 6.11 和 Qt Creator

推荐使用 Qt 官方安装器完成安装。安装过程中选择桌面开发相关组件,而不是只安装基础 Qt 文件。

典型选择包括:

  • Qt 6.11.x 对应的桌面开发组件
  • Qt Quick 模块
  • Qt Quick Controls 模块
  • Qt Creator
  • 与系统匹配的桌面编译器

Windows 环境通常选择 MSVC 或 MinGW 工具链;Linux 环境通常使用 GCC;macOS 环境使用 Clang。

安装完成后,可以通过 Qt Creator 检查 Kit 状态。

使用 Kit 验证开发链

打开 Qt Creator,进入设置中的 Kit 管理页面,确认 Qt 版本、编译器和 CMake 配置已经关联。

也可以通过命令行检查 Qt 工具是否可用:

bash
qmake --version

预期输出

text
QMake version <VERSION>
Using Qt version 6.11.x in <PATH>

实际版本号和安装路径会根据本机环境变化。

创建测试项目验证环境

在 Qt Creator 中创建一个 Qt Quick Application 项目,选择已经配置好的 Desktop Kit,然后执行构建。

构建成功说明以下链路已经打通:

  • Qt 安装目录可访问
  • QML 模块可以被解析
  • 编译器能够生成桌面程序
  • CMake 可以完成项目配置

如果出现 Kit 不可用,优先检查 Qt 版本与编译器是否匹配,而不是重新安装所有组件。

常见安装问题

Qt Creator 找不到 Qt 版本时,通常是 Qt 安装目录没有被正确识别。可以重新打开 Qt Creator 的 Kit 设置,检查 Qt 版本路径。

如果项目可以配置但无法编译,需要检查系统编译器是否安装。例如 Windows 使用 MSVC 时,需要安装对应版本的 Visual Studio Build Tools。

完成环境验证后,后续 QML 项目都可以基于这个 Desktop Kit 创建和运行。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Qt 6 与 QML 开发组件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通