Qt：windows下Qt安装教程

Qt：windows下Qt安装教程

软件下载

注意： 官⽹很慢，所以我们⼀般是使⽤湖心亭看雪原文及翻译 国内镜像⽹站：

注意：安装时尽量选择某个⾼的版本，⽐如你要安装qt5.14.x系列的版本，⽬前有qt5.14.0、qt5.14.2、qt5.14.3，那就选择

qt5.14.3

例⼦：不要安装qt5.14.0，因为没有办法打包，是官⽅bug。这个bug在qt5.14.2和qt5.14.3中得到了解决

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

下载好之后的安装包:

⽬录说明（可以不看）

项⽬说明

snapshots预览版，最新的开发测试中的 Qt 库和开发⼯具。

onlineQt 在线安装源。

official_releas正式发布版，是与开发版相对的稳定版 Qt 库和开发⼯具（可以下载Qt开发环境和源代码）

ministro迷你版，⽬前是针对 Android 的版本。

learning有学习 Qt 的⽂档教程和⽰范视频。

development_releas开发版，有新的和旧的不稳定版本，在 Qt 开发过程中的⾮正式版本。

community_releas社区定制的 Qt 库，Tizen 版 Qt 以及 Qt 附加源码包。

archive各种 Qt 开发⼯具安装包，新旧都有（可以下载 Qt 开发环境和源代码）。

archive 和 official_releas 两个⽬录都有最新的 Qt 开发环境安装包，我们以 archive ⽬录⾥的内容为例来说明。点击进⼊ archive ⽬

录:

项⽬说明

vsaddin这是 Qt 针对 Visual Studio 集成的插件

这是 Qt 官⽅的集成开发⼯具，但是 qtcreator 本⾝是个空壳，它没有编译套件和 Qt 开发库。除了⽼版本的 Qt 4 需要⼿动下载

qtcreatorqtcreator、编译套件、Qt 开发库进⾏搭配之外，⼀般⽤不到。对于我们教程压根不需要下载它，因为 Qt 5 有专门的⼤安装包，⾥⾯

包含开发需要的东西，并且能⾃动配置好。

qt这是 Qt 开发环境的下载⽬录，我们刚说的 Qt 5 的⼤安装包就在这⾥⾯。

online_installers在线安装器，国内⽤户不建议使⽤，在线安装是龟速，还经常断线。我们教程采⽤的全部是离线的⼤安装包。

我们再进⼊ qt ⼦⽬录 ，看到如下列表：

这个 qt ⽬录包含了所有的 Qt 版本，从 1.0 到⽬前的 6.0。

进⼊ 5.12 ⽬录，会看到各种⼦版本：

这⾥解释⼀下 Qt 的版本号，⽐如 5.12.8 是完整的 Qt 版本号，第⼀个数字 5 是⼤版本号（major），第⼆个数字 12 是⼩版本号

（minor），第三个数字 8 是补丁号（patch）。 只要前⾯两个数字相同，Qt 的特性就是⼀致的，最后的数字是对该版本的补丁更新。也

就是说本教程对 系列的 Qt 都是通⽤的，下载 任意⼀个版本都可以，这⾥我们以下载 5.12.2。

5.12.*5.12.*

点击5.12.2：

我们以 Windows 安装包（）讲解⼀下 Qt 安装包命名规则，其中：

opensource 是指开源版本；

windows 是指开发环境的操作系统；

x86 是指 32 位系统；

5.9.0 是 Qt 版本号。

软件安装

Step1: 管理员权限运⾏安装包, 稍等⽚刻, 然后点击next

Step2: 如果没有账号, 则选择skip，不过现在已经不允许skip了，必须先注册⼀个

Step3: Qt设置欢迎界⾯, 选择下⼀步

Step4: 选择安装路径

Step5: 选择组件, 然后选择下⼀步

Qt 的安装组件分为两部分：⼀部分是“Qt ”分类下的，该分类包含的是真正的 Qt 开发库组件；另⼀部分是“Tools”分类下的，

该分类包含的是集成开发环境和编译⼯具。

“Qt ”组件说明：（⼀般选择MinGW xxx， Qt xxx就可以了）

组件说明

MSVC针对 Windows 平台上的 MSVC 编译器的 Qt 组件，如 msvc2015 32-bit 和 msvc2015 64-bit 等。安装该组件需要计算机上已经安装相应

***版本的 Visual Studio。

MinGW

***

编译器模块。MinGW 是 Minimalist GNU for Windows 的缩写，MinGW 是 Windows 平台上使⽤的 GNU ⼯具集导⼊库的集合。

UWP ***

WP 是 Windows 10 中 Universal Windows Platform 的简称，有不同编译器类型的 UWP，属于 MSVC 编译器⽣成的 Qt 库。如果不是开

发 UWP 应⽤程序，就不需要，直接忽略。

Android

***

SourcesQt 的源代码包，除⾮你想阅读 Qt 的源码，否则不⽤安装。 建议选择，因为某个时候你可能需要它

这是针对安卓应⽤开发的 Qt 库，⼀般情况下⽤不到

Qt 的附加模块，⼤部分建议安装，这些附加模块括号⾥的 TP 是指 Technology Preview ，技术预览模块的意思，还处在功能测试阶段，不是

Qt ***正式版模块；附加模块括号⾥的 Deprecated 是指抛弃的旧模块，兼容旧代码使⽤的，⼀般⽤不到(如果不是为和以前开发的源程序兼容，过时

的模块不要选择)。这些附加模块读者可以选择部分或都勾选了安装，占⽤空间不⼤。

部分组件说明：

Qt Charts 是⼆维图表模块，⽤于绘制柱状图、饼图、曲线图等常⽤⼆维图表。

Qt Data Visualization 是三维数据图表模块，⽤于数据的三维显⽰，如散点的三维空间分布、三维曲⾯等。

“Tools”分类下的开发组件（⼀般选择Qt从零开始学摄影 Creator xxx 和MinGW xxxxx）

组件说明

Qt Creator xxx这是集成开发环境，强制安装的，以后所有的项⽬和代码都在 Qt Creator ⾥⾯新建和编辑。

Qt Creator xxxx CDB

Debugger surpport

MinGW xxxxx这是开源的编译器套件，建议安装

⽤于和 CDB 调试⼯具对接，默认安装，⼀般⽤于调试 VC 编译的 Qt 程序。

⽤于编译 Qt 源代码的 Perl 开发环境，不需要安装。如果读者以后⽤到，也可以另外⼿动安装，在搜索引擎搜索

Strawberry Perl 关键词，去 Strawberry Perl 官⽹下载最新的安装包是⼀样⽤的。

Strawberry Perl 5.22.1.3

Step6: 同意许可协议, 然后选择下⼀步

Step7: 开始菜单快捷⽅式

可以修改在菜单中显⽰的名字, 然后下⼀步

Step8: 点击安装即可

Step9: 选择下⼀步

Step10: 完成Qt向导

Step11: 完成安装, 打开软件

安装完成之后，在 Windows“开始”菜单中会看到 Qt 的 程序组。

程序说明

Assistant（Qt 助⼿）⽤来查看帮助⽂档，已被集成在 Qt Creator 中。

Designer（Qt 设计师）图形界⾯可视化编辑⼯具，已被集成在 Qt Creator 中，在 Qt Creator 中编辑或创建界⾯⽂件时，就可以⾃动打开。

Linguist（Qt 语⾔家）多国语⾔翻译⽀持⼯具，可以⽤来编辑语⾔资源⽂件，在开发多语⾔界⾯的应⽤程序时会⽤到。

Qt .x(MinGW 5.3.0 32bit)Qt 命令⾏⼯具，⽤来配置 Qt 开发环境（主要是设置 PATH 变量）

测试是否安装成功

运⾏qt⽰例测试是否安装成功

qt⾃带了很多⼩例⼦，是我们学习的好帮⼿。运⾏⽅法：

step1：打开软件，进⼊欢迎–>⽰例，然后随便点击⼀个实例

step2：点击config project

step：这个时候它会调到编辑页⾯，可以看出打开了这个项⽬，接下来我们就可以运⾏这个项⽬了

新建项⽬测试是否安装成功

Step1: 新建⼀个项⽬

Step2: 选择Qt控件项⽬

Step3: 项⽬介绍和位word怎么自动生成目录 置

Step4: 选择Kit

Step5: 类信息

默认即可

Step6: 项⽬管理

Step7: 运⾏项⽬

Step8: 结果测试

如果出现⼀个窗⼝, 表⽰软件已经安装好了

Qt安装⽬录结构说明

Qt 整体⽬录结构

不同版本 Qt 的安装⽬录结构⼤同⼩异，本节我们以 Qt 5.9.0 为例来说明，如下图所⽰。

注意，~5.9 和 ~Tools ⽬录下都有 mingw53_32 ⽬录（图中我⽤红⾊标出来了），但是两者是有区别的：

~5.9mingw53_32 ⽬录包含的是 Qt 的类库⽂件，例如头⽂件、静态库、动态库等，这些类库⽂件使⽤ MinGW ⼯具集编译⽽

成。

~Toolsmingw53_32 ⽬录包含的是 MinGW ⼯具集，例如编译器 g++、链接器 ld、make ⼯具、打包⼯具 ar 等。

QtCreator 使⽤ MSVC2015 编译⽣成的，所以安装⽬录⾥有⼀个 vcredist ⽂件夹存储 VC 运⾏库安装⽂件。

，对于离线安装包，它只能⽤于删除软件包，如果 Qt 开发环境是⽤在线安装⽅式装的，这个⼯具还可以管理开发

环小学生座右铭 境组件和升级组件

Qt 类库的帮助⽂件位于 Docs ⽂件夹⾥，需要⽤ Qt Assistant ⼯具才能查看

Examples ⾥是⽰例代码，可以⽤ 免费签名 QtCreator 集成开发环境打开各个⽰例。

Qt 类库⽬录

Qt⽤到的开发⼯具

Qt 不是凭空产⽣的，它是基于现有⼯具链打造⽽成的，它所使⽤的编译器、链接器、调试器等都不是⾃⼰的，Qt 官⽅只是开发了上层⼯

具。下⾯我们分⼏个部分讲解 Qt 使⽤到的⼯具链。

GNU ⼯具集

在上个世纪⼋⼗年代，计算机都是奢侈品，操作系统⾥最著名的是 Unix 家族， 当时还没有 Windows、Linux 之类的，Unix 系统都是商

业软件，⾥⾯的应⽤软件也是商业软件， 全是封闭的环境。

系统程序员 Richard M. Stallman (RMS) 在此环境下创⽴了与众不同的 GNU 项⽬ (GNU’s Not Unix) ， 以及推进⾃由软件发展的

Free Software Foundation (FSF) ⾃由软件基⾦会。

GNU 项⽬是为了创建⾃由的类 Unix 系统，也因此开发出来很多开源的系统⼯具，其中⾮常著名的就是 GCC （GNU Compiler

Collection，GNU编译器套件）。

现在我们知道，GUN 开发类 Unix 系统的项⽬失败了，但是它开发的⼀系列⼯具集却⽤到了后来的 Linux 内核上，两者结合形成了今天的

各种 Linux 发⾏版

在 GNU ⼯具集⾥⾯，开发时常见到的⼏个罗列如下（这些⼯具通常位于 Linux 或 Unix 系统⾥的 /usr/bin/ ⽬录）：

⼯具说明

gccGNU C 语⾔编译器

g++GNU C++ 语⾔编译器。

ldG碧血剑武功排名 NU 链接器，将⽬标⽂件和库⽂件链接起来，创建可执⾏程序和动态链接库。

ar⽣成静态库 .a ，可以编辑和管理静态链接库。

make⽣成器，可以根据 makefile ⽂件⾃动编译链接⽣成可执⾏程序或库⽂件。

gdb调试器，⽤于调试可执⾏程序。

ldd查看可执⾏⽂件依赖的共享库（扩展名 .so，也叫动态链接库）。

MinGW

原本 GNU ⼯具只在 Linux/Unix 系统⾥才有，随着 Windows 系统的⼴泛使⽤， 为了在 Windows 系统⾥可以使⽤ GNU ⼯具，诞⽣了

MinGW（Minimalist GNU for Windows） 项⽬，利⽤ MinGW 就可以⽣成 Windows ⾥⾯的 exe 程序和 dll 链接库。

需要注意的是，MinGW 与 Linux/Unix 系统⾥ GNU ⼯具集的有些区别：

MinGW ⾥⾯⼯具带有扩展名 .e好听的歌曲推荐 xe， Linux/Unix 系统⾥⼯具通常都是没有扩展名的。

MinGW ⾥⾯的⽣成器⽂件名为 ，Linux/Unix 系统⾥就叫 make。

MinGW 在链接时是链接到 库引⽤⽂件，⽣成的可执⾏程序运⾏时依赖 学习卡片 ，⽽ Linux/Unix 系统⾥链接时和运⾏时都是使

*.a*.dll

⽤。

*.so

另外 MinGW ⾥也没有 ldd ⼯具，因为 Windows 不使⽤ .so 拉神 共享库⽂件。如果要查看 Windows ⾥可执⾏⽂件的依赖库，需要使⽤微软

⾃家的 Dependency Walker ⼯具。Windows ⾥⾯动态库扩展名为 .dll，MinGW 可以通过 dlltool 来⽣成⽤于创建和使⽤动态链接库需

要的⽂件，如 .def 和 .lib。

MinGW 原本是⽤于⽣成 32 位程序的，随着 64 位系统流⾏起来， 从 MinGW 分离出来了 MinGW-w64 项⽬，该项⽬同时⽀持⽣成 64

位和 32 位程序。Qt 的 MinGW 版本库就是使⽤ MinGW-w64 项⽬⾥⾯的⼯具集⽣成的。

如今， MinGW 现已被 MinGW-w64 所取代。感兴趣的可以阅读

MSYS（Minimal SYStem）

由于ming-gw本⾝主要是编译链接等⼯具和头⽂件、库⽂件，并不包含系统管理，⽂件操作之类的shell环境，这对希望⽤类Unix命令的开

发者来说是不够⽤的。所以MinWG官⽅⼜推出了MSYS（Minimal SYStem），相当于是⼀个部署在Windows系统中的⼩型Unix系统环

境，移植了很多Unix/Linux命令⾏和配置⽂件等，是对MinGW的扩展。

MSYS 对于熟悉 Unix/Linux 系统环境或者要尝试学习 Unix/Linux 系统的⼈都是⼀种便利。MSYS 和 MinGW 的安装升级都是通过其官

⽅的 mingw-get ⼯具实现，⼆者是统⼀下载安装管理的。

对于 MinGW-w64 项⽬，它对应的⼩型系统环境叫 MSYS2（Minimal SYStem 2），MSYS2 是 MSYS 的衍⽣版，不仅⽀持 64 位系

统和 32 位系统，还有⾃⼰的独特的软件包管理⼯具，它从 Arch Linux 系统⾥移植了 pacman 软件管理⼯具，所以装了 MSYS2 之后，

可以直接通过 pacman 来下载安装软件，⽽且可以⾃动解决依赖关系、⽅便系统升级等。装了 MSYS2 之后，不需要⾃⼰去下载 MinGW-

w64，可以直接⽤ pacman 命令安装编译链接⼯具和 git ⼯具等。

Qt⼯具集

⼯具说明

核⼼的项⽬构建⼯具，可以⽣成跨平台的 .pro 项⽬⽂件，并能依据不同操作系统和编译⼯具⽣成相应的 Makefile，⽤于构建可执⾏程序或链

接库

Ur Interface Compiler，⽤户界⾯编译器，Qt 使⽤ XML 语法格式的 .ui ⽂件定义⽤户界⾯，uic 根据 .ui ⽂件⽣成⽤于创建⽤户界⾯的

C++ 代码头⽂件，⽐如 ui_*****.h 。

Meta-Object Compiler，元对象编译器，moc 处理 C++ 头⽂件的类定义⾥⾯的 Q_OBJECT 宏，它会⽣成源代码⽂件，⽐如

moc_*****.cpp ，其中包含相应类的元对象代码，元对象代码主要⽤于实现 Qt 信号/槽机制、运⾏时类型定义、动态属性系统。

Resource Compiler，资源⽂件编译器，负责在项⽬构建过程中编译 .qrc 资源⽂件，将资源嵌⼊到最终的 Qt 程序⾥。rcc

集成开发环境，包含项⽬⽣成管理、代码编辑、图形界⾯可视化编辑、 编译⽣成、程序调试、上下⽂帮助、版本控制系统集成等众多功能， 还

⽀持⼿机和嵌⼊式设备的程序⽣成部署。

Qt 助⼿，帮助⽂档浏览查询⼯具，Qt 库所有模块和开发⼯具的帮助⽂档、⽰例代码等都可以检索到，是 Qt 开发必备神器，也可⽤于⾃学

Qt。

Qt 设计师，专门⽤于可视化编辑图形⽤户界⾯（所见即所得），⽣成 .ui ⽂件⽤于 Qt 项⽬。designer

Qt 语⾔家，代码⾥⽤ tr() 宏包裹的就是可翻译的字符串，开发⼈员可⽤ lupdate 命令⽣成项⽬的待翻译字符串⽂件 .ts，⽤ linguist 翻译多

国语⾔ .ts ，翻译完成后⽤ lrelea 命令⽣成 .qm ⽂件，然后就可⽤于多国语⾔界⾯显⽰。

在 Qt 4.x ⾥是⽤ qmlviewer 进⾏ QML 程序的原型设计和测试，Qt 5 ⽤ qmlscene 取代了旧的 qmlviewer。新的 qmlscene 另外还⽀持

Qt 5 中的新特性 scenegraph 。

qmake

uic

moc

qtcreator

assistant

linguist

qmlscene

Qt卸载

继续下⼀步，确定就可以了