Qt5 C++ GUI界面 开发环境配置 详细教程

本博客已暂停更新，需要请转新博客http://www.whbwiki.com/333.html

Qt 下载

Qt 体积很大，有 1GB~3GB，官方下载通道非常慢，相信很多读者会崩溃，所以建议大家使用国内的镜像网站（较快），或者使用迅雷下载（很快）。作为 Qt 下载教程，本文会同时讲解以上三种下载方式。

Qt 官方下载（非常慢）

Qt 官网有一个专门的资源下载网站，所有的开发环境和相关工具都可以从这里下载，具体地址是：http://download.qt.io/

​ 图1：Qt 官方下载网站截图

目录	说明
archive	各种 Qt 开发工具安装包，新旧都有（可以下载 Qt 开发环境和源代码）。
community_releases	社区定制的 Qt 库，Tizen 版 Qt 以及 Qt 附加源码包。
development_releases	开发版，有新的和旧的不稳定版本，在 Qt 开发过程中的非正式版本。
learning	有学习 Qt 的文档教程和示范视频。
ministro	迷你版，目前是针对 Android 的版本。
official_releases	正式发布版，是与开发版相对的稳定版 Qt 库和开发工具（可以下载Qt开发环境和源代码）。
online	Qt 在线安装源。
snapshots	预览版，最新的开发测试中的 Qt 库和开发工具。

archive 和 official_releases 两个目录都有最新的 Qt 开发环境安装包，我们以 archive 目录里的内容为例来说明。点击进入 archive 目录，会看到四个子目录：

​ 图2：进入 archive 目录

目录	说明
vsaddin	这是 Qt 针对 Visual Studio 集成的插件，本教程基本不使用 Visual Studio ，所以不需要插件。
qtcreator	这是 Qt 官方的集成开发工具，但是 qtcreator 本身是个空壳，它没有编译套件和 Qt 开发库。 除了老版本的 Qt 4 需要手动下载 qtcreator、编译套件、Qt 开发库进行搭配之外，一般用不到。对于我们教程压根不需要下载它，因为 Qt 5 有专门的大安装包，里面包含开发需要的东西，并且能自动配置好。
qt	这是 Qt 开发环境的下载目录，我们刚说的 Qt 5 的大安装包就在这里面。
online_installers	在线安装器，国内用户不建议使用，在线安装是龟速，还经常断线。我们教程采用的全部是离线的大安装包。

我们再进入 qt 子目录 ，看到如下列表：

​ 图3：进入 qt 子目录

上图没有列完整，这个 qt 目录包含了所有的 Qt 版本，从 1.0 到目前的 5.12 。

由于 Qt 5.9 是一个长期技术支持版本（Long Term Support，LTS），在未来几年里都将有更新支持，因此，本教程以 Qt 5.9 LTS 版本为例进行讲解，并且所有实例程序均使用 Qt 5.9 编译测试通过。

Qt 的上一个 LTS 版本是 5.6，它其实已经超出支持期了。

进入 5.9 目录，会看到各种子版本：

​ 图4：Qt 5.9 的各个子版本

这里解释一下 Qt 的版本号，比如 5.9.8 是完整的 Qt 版本号，第一个数字 5 是大版本号（major），第二个数字 9 是小版本号(minor)，第三个数字 8 是补丁号 (patch)。 只要前面两个数字相同，Qt 的特性就是一致的，最后的数字是对该版本的补丁更新。也就是说本教程对 5.9.* 系列的 Qt 都是通用的，下载 5.9.* 任意一个版本都可以，这里我们以下载 5.9.0。

点击 5.9.0，进入子目录：

​ 图5：Qt 5.9.0 下载页面

根据不同的操作系统，选择不同的安装包即可，不用管源码包，除非你想自己编译或者阅读源码。

我们以 Windows 安装包（qt-opensource-windows-x86-5.9.0.exe）讲解一下 Qt 安装包命名规则，其中：

• opensource 是指开源版本；
• windows 是指开发环境的操作系统；
• x86 是指 32 位系统；
• 5.9.0 是 Qt 版本号。

Qt 国内镜像站下载（较快）

请读者注意图5中最后一栏的 Details 链接（红色方框圈起来的地方）。点击 Details 链接可以进入详情页，在该页面可以看到文件的大小、校验和以及世界各地镜像下载链接（这才是重点）。

​ 图6：国内镜像下载链接

可以清楚地看到，Qt 在国内的有三个镜像网站可以下载，点击这些地址中的一个就可以下载，从国内镜像网站下载速度快一些。

这里给大家推荐几个国内著名的 Qt 镜像网站，主要是各个高校的：

• 中国科学技术大学：http://mirrors.ustc.edu.cn/qtproject/
• 清华大学：https://mirrors.tuna.tsinghua.edu.cn/qt/
• 北京理工大学：http://mirror.bit.edu.cn/qtproject/
• 中国互联网络信息中心：https://mirrors.cnnic.cn/qt/

国内镜像网站的结构和官方是类似的，我们在第一部分已经分析过了，这里不再赘述。

迅雷下载（很快）

将 Qt 软件的下载地址复制到迅雷的下载框，如果迅雷官方有资源，就会自动识别，下载速度就很快了。

如何找到 Qt 软件的下载地址呢？以清华大学开源软件镜像站为例，进入 Qt 5.9.0 的下载目录（https://mirrors.tuna.tsinghua.edu.cn/qt/archive/qt/5.9/5.9.0/），在某个链接处单击鼠标右键，会弹出一个菜单，选择“复制链接地址”，如下图所示：

​ 图7：找到 Qt 下载地址

这样就把 Qt 5.9.0 的下载地址（具体为 https://mirrors.tuna.tsinghua.edu.cn/qt/archive/qt/5.9/5.9.0/qt-opensource-windows-x86-5.9.0.exe）复制到了剪切板，然后再粘贴到迅雷的下载框：

​ 图8：把Qt下载地址粘贴到迅雷下载框

点击 **立即下载 **按钮，稍等片刻，迅雷会自动匹配到资源，速度飞快

​ 图9：下载速度 2.7MB/s

注意，常用的 Qt 版本一般都能匹配到资源，但是不保证每个版本都能匹配到资源，上面的例子仅对清华大学镜像站的 Qt 5.9.0 Windows 版 https://mirrors.tuna.tsinghua.edu.cn/qt/archive/qt/5.9/5.9.0/qt-opensource-windows-x86-5.9.0.exe 有效。

扩展阅读

对 Qt 版本更新感兴趣的读者请访问 Qt wiki 网站，地址为：https://wiki.qt.io/Main

Qt wiki 网站会显示最新的正式版、LTS 版、正在开发中的版本等等，比主站 https://www.qt.io/ 靠谱多了。Qt 主站因为商业推广的原因，安装包的下载步骤非常繁琐。

Windows安装

注意

目前较高版本的 Qt 仅支持 Win7 及其以后的操作系统，不支持 Win XP；使用 Win XP 的读者请安装 Qt 5.5.1 之前的版本。

Qt 占用的存储空间很大，安装之前建议先准备好 8GB 以上的磁盘空间。对于目前 Qt 最新版开发环境，如果不安装源代码包，实际占用大约 5.5GB；如果选择安装源码包，大约占用 7.5GB。

双击下载得到的 qt-opensource-windows-x86-5.9.0.exe 即可开始安装。Qt 的安装过程和普通的 Windows 软件一样，按照向导进行操作即可。

关于 Qt 的安装需要说明以下几点。

1) 注册和登录

Qt 在安装过程中会提示用户进行注册和登录，不用理会，跳过（Skip）即可，实际开发时不需要登录。

2) 安装路径和关联文件

Qt 允许用户自定义安装路径，但是请注意，安装路径不能带空格、中文字符或者其它任何特殊字符。

另外，该界面还会询问是否关联特定的文件类型。如果关联（默认是关联的），特定后缀的文件（包括 .cpp 文件）默认使用 Qt 打开。我喜欢使用纯文本编辑器（例如 Sublime Text）来打开 C++ 源文件，所以我取消了该选项，读者根据自己的实际情况定夺。

3) 选择安装组件

Qt 安装过程中最关键的一步是组件的选择，请看下图：

Qt 的安装组件分为两部分：一部分是“Qt 5.9”分类下的，该分类包含的是真正的 Qt 开发库组件；另一部分是“Tools”分类下的，该分类包含的是集成开发环境和编译工具。

Qt 安装组件及其说明

组件	说明
	“Qt 5.9”分类下的开发组件
MinGW 5.3.0 32 bit	编译器模块。MinGW 是 Minimalist GNU for Windows 的缩写，MinGW 是 Windows 平台上使用的 GNU 工具集导入库的集合。是本教程使用 MinGW 编译，所以必须安装。
UWP	UWP 是 Windows 10 中 Universal Windows Platform 的简称，有不同编译器类型的 UWP，属于 MSVC 编译器生成的 Qt 库。如果不是开发 UWP 应用程序，就不需要，直接忽略。
MSVC	针对 Windows 平台上的 MSVC 编译器的 Qt 组件，如 msvc2015 32-bit 和 msvc2015 64-bit 等。安装该组件需要计算机上已经安装相应版本的 Visual Studio。如果你不使用 MSVC 编译器进行开发，就不用安装。本教程使用 MinGW 编译组件，所以不用安装 MSVC *** 组件。
Android	这是针对安卓应用开发的 Qt 库，如果读者有安卓开发这方面需求可以自己选择安装，一般情况下用不到。
Sources	Qt 的源代码包，除非你想阅读 Qt 的源码，否则不用安装。
Qt
	“Tools”分类下的开发组件
组件	说明
Qt Creator 4.3.0	这是集成开发环境，强制安装的，以后所有的项目和代码都在 Qt Creator 里面新建和编辑。
Qt Creator 4.3.0 CDB Debugger surpport	用于和 CDB 调试工具对接，默认安装，一般用于调试 VC 编译的 Qt 程序。
MinGW 5.3.0	这是开源的编译器套件，这本教程必须用到的，需要读者勾选安装。
Strawberry Perl 5.22.1.3	用于编译 Qt 源代码的 Perl 开发环境，不需要安装。如果读者以后用到，也可以另外手动安装，在搜索引擎搜索 Strawberry Perl 关键词，去 Strawberry Perl 官网下载最新的安装包是一样用的。

选择完了组件，根据向导一步一步操作就可以了。安装完成后，在 Windows“开始”菜单中会看到 Qt 5.9.0 程序组。

程序	说明
Qt Creator 4.6.2 (Enterprise)	Qt 的集成开发环境，本教程就使用它来创建和管理 Qt 项目。
Assistant（Qt 助手）	用来查看帮助文档，已被集成在 Qt Creator 中。
Designer（Qt 设计师）	图形界面可视化编辑工具，已被集成在 Qt Creator 中，在 Qt Creator 中编辑或创建界面文件时，就可以自动打开。
Linguist（Qt 语言家）	多国语言翻译支持工具，可以用来编辑语言资源文件，在开发多语言界面的应用程序时会用到。
Qt 5.11.1 for Desktop (MinGW 5.3.0 32bit)	Qt 命令行工具，用来配置 Qt 开发环境（主要是设置 PATH 变量）。

温馨提示：你可以将 Assistant 直接拖到桌面建立快捷方式，方便自己以后查询使用。

Linux安装

Linux 发行版虽然众多，但 Qt 安装过程大同小异，本节以 CentOS 7 为例来演示 Qt 的安装。

上文已经讲解了 Qt 安装包的下载方式，Qt 5.9.0 Linux 安装包的名称为 qt-opensource-linux-x64-5.9.0.run。

下载的 run 文件不一定具有可执行权限， 可以执行如下命令开启执行权限：

chmod +x /文件夹路径/qt-opensource-linux-x64-5.9.0.run

将“文件夹路径”替换为自己系统里该 run 文件的路径即可。然后可以直接点击运行该 run 文件，开始安装。

注意以下是以普通用户权限安装的, 安装位置是 /home/用户名/Qt5.9.0/, 如果希望安装到其他的目录(如 /opt/ 目录)，是需要 root 权限的。

下面示范简单的普通用户安装方式，需要用户主目录 /home 所在磁盘分区至少剩余 2GB 空间。所示范的是 64 位安装包，使用的发行版是 CentOS 7（64 位）。

运行 qt-opensource-linux-x64-5.9.0.run 文件，根据向导一步步安装就可以了。关于 Qt 的安装需要说明以下几点。

1) 注册和登录

Qt 在安装过程中会提示用户进行注册和登录，不用理会，跳过（Skip）即可，实际开发时不需要登录。

​ 图1：Qt 安装过程中提示用户注册

2) 安装路径

Qt 在安装过程中允许自定义安装路径，我将 Qt 安装在主目录下的 programs/Qt5.9.0 文件夹中，一般使用默认路径即可。

​ 图2：指定 Qt 安装路径

3) 选择安装组件

Qt 安装过程中最关键的一步是组件的选择，请看下图：

​ 图3：Qt 组件

Qt 的安装组件分为两部分：一部分是“Qt 5.9”分类下的，该分类包含的是 Qt 开发库，也就是动态链接库或者静态链接库；另一部分是“Tools”分类下的，该分类包含的是集成开发环境（可执行程序），也就是 Qt Creator（在 Windows 下还会有其它工具）

	“Qt 5.9”分类下的开发库
开发库	说明
Desktop gcc 64-bit	这是使用桌面版 GCC 64-bit 编译环境生成的 Qt 库，是 Qt 的核心，必须安装。 注意，虽然名字看起来像是 GCC 编译器套件，但实际上说的是 Qt 库的编译环境。大部分 Linux 发行版 都会预装 GCC 编译器套件，所以 Qt 安装包没必要附带它们。
Android	这是针对安卓应用开发的 Qt 库，如果读者有安卓开发这方面需求可以自己选择安装，一般情况下用不到。
Sources	Qt 的源代码包，除非你想阅读 Qt 的源码，否则不用安装。
Qt	Qt 的附加模块，大部分建议安装，这些附加模块括号里的 TP 是指 Technology Preview ，技术预览模块的意思，还处在功能测试阶段，不是正式版模块；附加模块括号里的 Deprecated 是指抛弃的旧模块，兼容旧代码使用的，一般用不到。这些附加模块读者可以选择部分或都勾选了安装，占用空间不大。 部分组件说明： Qt Charts 是二维图表模块，用于绘制柱状图、饼图、曲线图等常用二维图表。 Qt Data Visualization 是三维数据图表模块，用于数据的三维显示，如散点的三维空间分布、三维曲面等。 Qt Scritp（Deprecated）是脚本模块，已被抛弃，不建议安装。
	“Tools”分类下的集成开发环境
集成开发环境	说明
Qt Creator 4.3.0	这是集成开发环境，强制安装的，以后所有的项目和代码都在 Qt Creator 里面新建和编辑。

选择完了组件，根据向导一步一步操作就可以了。安装完成后，在左上角“应用程序 --> 编程”菜单中可以看到 Qt Creator，证明安装成功了。点击 Qt Creator，就可以开始 Qt 编程了。

​ 图4：Qt 安装完成

结束

至此，马上开始你的Qt学习之旅吧！！！