桌面应用 / 系统课时

安装 Qt 6 与 Qt Creator

安装 Qt 6 与 Qt Creator

本篇解决 Qt 6 桌面开发环境无法开始编码的问题。你将完成 Qt 版本、桌面组件和开发工具安装,并确认编译器、Qt Kit 与 Qt Creator 能协同工作,为后续创建项目做好准备。

学习目标

  • 理解 Qt 6 安装时需要选择的核心组件和开发工具
  • 完成 Qt Creator、Qt 库以及编译器 Kit 的配置检查
  • 使用简单方式验证本地环境是否可以构建 Qt 应用

选择 Qt 6 开发组件

Qt 桌面开发环境由多个部分组成,其中 Qt Creator 负责编辑和调试,Qt 库提供 Widgets、Core 等开发模块,编译器负责将 C++ 源码构建为可执行程序。

安装时需要根据目标平台选择对应 Kit。例如 Windows 常见组合是 MinGW 或 MSVC Kit,Linux 通常使用系统 GCC,macOS 则使用 Clang 工具链。

通过 Qt 官方安装器安装时,重点确认以下内容:

  • Qt 6.x 对应版本已经选中
  • 桌面开发模块已经安装
  • 至少有一个可用编译器 Kit
  • Qt Creator 已安装

安装后检查 Qt Creator 环境

打开 Qt Creator 后,可以在设置中的 Kits 页面查看已识别的编译器、Qt 版本和调试器。如果 Kit 缺少编译器,项目创建后通常无法完成构建。

也可以通过终端检查 Qt 工具是否可用。下面示例使用 Qt 提供的命令行工具查询版本,实际路径可能因安装位置不同而变化。

bash
qmake --version

预期输出

text
QMake version <VERSION>
Using Qt version 6.x.x in <QT_PATH>

如果系统找不到命令,可以直接使用 Qt 安装目录中的 qmake,或者在 Qt Creator 中选择已经安装好的 Kit。

验证编译器 Kit

创建或打开项目时,Qt Creator 会要求选择 Kit。一个有效 Kit 通常包含:

项目 作用
Qt Version 提供 Qt 6 库文件
Compiler 编译 C++ 源码
Debugger 调试程序运行状态

常见安装问题

如果 Qt Creator 可以启动但无法构建项目,优先检查 Kit 配置,而不是重新安装所有组件。常见原因包括:

  • 安装 Qt 时未选择对应编译器
  • 系统编译器版本与 Qt Kit 不匹配
  • 项目使用的 Qt 版本已经被删除

完成检查后,环境应达到可以创建 Qt Widgets Application 并执行 Build 的状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

安装 Qt 6 与 Qt Creator

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

登录哪都通