桌面应用 / 系统课时
安装 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 工具是否可用:
qmake --version预期输出
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 创建和运行。