Qt最新版在Windows下安装

本节介绍最新版本 Qt 开发环境在 Windows 系统里的安装，然后简要介绍 Qt 开发环境的目录结构和 Qt 命令行脚本内容。

1. 安装 Qt 开发环境

目前 Windows 系统最新的 Qt 安装包仅支持 Win7 和之后的操作系统，不支持 WinXP，如果希望支持旧系统，那么建议安装 Qt 5.5.1 之前版本。本节介绍最新版本 Qt 开发环境安装。

下载最新的安装包 qt-opensource-windows-x86-5.11.1.exe 之后，我们开始安装 Qt 开发环境，本教程主要采用基于 MinGW 编译的 Qt 版本，安装过程也是只安装 MinGW 版本 Qt。安装之前，需要预先准备好磁盘空间，建议分区空余空间8GB以上。对于目前 Qt 最新版开发环境，如果不安装源代码包，实际占用大约 5.5 GB；如果选择安装源码包大概 7.5 GB。

我们右击安装包，以管理员权限运行，看到如下安装程序界面：


上图界面是希望建立网络连接，可以不用管，直接点击“Next”，进入指定 Qt 联机账户的界面：

安装 Qt 并不需要注册账户，不用理它，我们点击“Skip”，进入真正的开始界面：

在上图界面点击“下一步”，进入安装路径选择界面：


如果 C 盘剩余空间有 8 GB以上，那么可以直接装在 C 盘默认路径，否则安装到其他磁盘分区，注意安装路径不能带任何特殊字符或中文字符！
设置好安装路径后，点击“下一步”，进入安装组件选择界面：

最新版 Qt 的安装组件非常多，Tools 目录是集成开发环境和编译器工具，我们先介绍下面 Tools 目录里面的组件：
然后我们来看看 Qt 5.11.1 目录，这个目录里面才是真正的 Qt 开发库组件：
Qt 5.11.1 目录里有非常多的东西，归为如下几类：
勾选好安装组件后，点击“下一步”，进入许可协议界面：
选择“I have read and agree to the terms contained in the license agreements.”这一栏，同意许可协议，点击“下一步”，进入“开始菜单快捷方式” 界面：
开始菜单快捷方式按照默认的即可，点击“下一步”：
现在准备工作就绪，我们点击“安装”，进入实际的安装过程：
耐心等待各个组件安装完成，如果之前勾选了 Sources 组件，那么会在安装开始的时候就安装这个源码包，大概会卡二十分钟，这个不要紧的，慢慢等就行了，安装完成后显示如下界面：
点击“下一步”，显示完成向导：

点击“完成”，上图中“Launch Qt Creator”会自动打开Qt Creator，该程序就是Qt的集成开发环境（Integrated Development Environment，IDE），可以先看看该开发工具，以后会慢慢讲。 到这里，安装就完成了。接下来看看安装后的文件夹里都有些什么。

2 Qt 开发环境目录结构

在 Windows 系统里安装的 Qt 开发环境大致可以划分为三个部分：Qt 类库、Qt Creator 和编译工具集。
另外如果安装了 Qt 源代码，则位于 C:\Qt\Qt5.11.1\5.11.1\Src 目录里面。我们将 Qt 开发环境安装后目录树绘图如下：
INSTALLDIR
注意在 5.11.1 文件夹里的是 Qt 类库，而在 Tools 文件夹里的才是真的 MinGW 工具集。Qt 类库是使用 MinGW 工具集编译而成的。QtCreator 是个例外，QtCreator 使用 MSVC2015 编译生成的，所以安装目录里有一个 vcredist 文件夹存储 VC 运行库安装文件。最后的 MaintenanceTool.exe ，对于离线安装包，它只能用于删除软件包，如果 Qt 开发环境是用在线安装方式装的，这个工具还可以管理开发环境组件和升级组件。Qt 类库的帮助文件位于 Docs 文件夹里，需要用 Qt Assistant 工具才能查看。Examples 里是示例代码，可以用 QtCreator 集成开发环境打开各个示例。

以 Qt 类库的目录 QTDIR 再细分查看，得到下图 Qt 类库根的目录树：
QTDIR
图上列的比较有限，主要是教大家熟悉一下 Qt 的开发环境，下面小节介绍 Qt 的命令行脚本。

3 Qt 命令行脚本

在开始菜单里“Qt 5.11.1”就是 Qt 开发工具的菜单目录，如下图所示：

startmenu
图中“Qt Creator 4.6.2 (Enterprise)”就是集成开发环境，而进一步打开 “5.11.1”-->“MinGW 5.3.0 (32-bit)”里面是 Qt 类库特有的工具，“Assistant” （Qt助手）是帮助文档查看工具，“Designer” （Qt设计师）是图形界面可视化编辑工具，“Linguist”（Qt语言家）是多国语言翻译支持工具，最后的“Qt 5.11.1 for Desktop (MinGW 5.3.0 32bit)” 就是 Qt 开发命令行，配置好了 Qt 开发需要的环境变量，打开它我们就可以从命令行编译 Qt 程序。
这个 Qt 命令行实际就是一句命令：
C:\Windows\System32\cmd.exe /A /Q /K  C:\Qt\Qt5.11.1\5.11.1\mingw53_32\bin\qtenv2.bat
这句就是调用了 cmd 命令行工具，选项 /A 使向内部管道或文件命令的输出成为 ANSI ， 选项 /Q 是关闭回应， 选项 /K 执行字符串指定的命令后命令行窗口继续存在。
该命令实际执行的脚本就是 C:\Qt\Qt5.11.1\5.11.1\mingw53_32\bin\qtenv2.bat ， 这是 Qt 开发环境的配置脚本。我们打开来看看它的内容：
@echo off
echo Setting up environment for Qt usage...
set PATH=C:\Qt\Qt5.11.1\5.11.1\mingw53_32\bin;C:/Qt/Qt5.11.1/Tools/mingw530_32\bin;%PATH%
cd /D C:\Qt\Qt5.11.1\5.11.1\mingw53_32
脚本里四句是非常简单的，第一句是关闭命令行回显（会看不到 set 和 cd 等命令显示）；
第二句是显示提示信息，表示会配置好 Qt 环境；
第三句是真实的配置命令，将 Qt 类库的 bin 目录和 MinGW 的 bin 目录添加到环境变量 PATH 里面，这个配置仅对当前窗口有效，不会修改系统启动里的 PATH。
注：Qt 5.11.1 里面的 qtenv2.bat 有点小bug，Windows命令行路径应该全是左斜杠 \ ，实际安装后 MinGW 路径出现了右斜杠 / ，好在 Windows 对左右斜杠都认识，所以可以正常用，在 Windows 系统建议还是统一为 \ 。
第四句是进入 Qt 类库的根目录（QTDIR）。
配置 Qt 环境实际上就设置一下 PATH 而已，其他的都不用管，非常省事。如果有其他 MinGW 编译而成的 Qt 库，配置脚本是类似的。

另外，Qt 新手常遇到的一个问题就是双击编译生成的 exe 不能运行，报出如下错误：
error
这是由于操作系统里PATH环境变量没有添加 Qt 和 MinGW 的运行库路径，遇到这种情况， 我们打开开始菜单里的 “Qt 5.11.1 for Desktop (MinGW 5.3.0 32bit)”命令行，然后将 exe 拖入 Qt 命令行后按回车键，在Qt 命令行里面运行exe就行了。