个人总结的 Qt 安装教程（转载）

（转自）http://wenku.baidu.com/link?url=R2g11j-imv5kV9r5Sg_9DhASFOy67LqMXXtaIq8Tir_Nwmdt-A6Aq1clVQmHzl0KLIEBK53rxm4knNrlW0bb3bAglyPUo7iZhRTrAlEcdOS

 

1. Qt 简介
Qt 是一个 1991 年由奇趣科技开发的跨平台 C++图形用户界面应用程序开发框架。它既可
以开发 GUI 程序，也可用于开发非 GUI 程序，比如控制台工具和服务器。 Qt 是面向对象的
框架，使用特殊的代码生成扩展（称为元对象编译器(Meta Object Compiler, moc)）以及一
些宏，易于扩展，允许组件编程。 2008 年，奇趣科技被诺基亚公司收购， QT 也因此成为
诺基亚旗下的编程语言工具。 2012 年， Qt 被 Digia 收购。 2014 年 4 月，跨平台集成开发
环境 Qt Creator 3.1.0 正式发布，实现了对于 iOS 的完全支持，新增 WinRT、 Beautifier 等
插件，废弃了无 Python 接口的 GDB 调试支持，集成了基于 Clang 的 C/C++代码模块，并
对 Android 支持做出了调整，至此实现了全面支持 iOS、 Android、 WP。
Qt 是 1991 年奇趣科技开发的一个跨平台的 C++图形用户界面应用程序框架。它提供给应
用程序开发者建立艺术级的图形用户界面所需的所有功能。 Qt 很容易扩展，并且允许真正
地组件编程。基本上， Qt 同 X Window 上的 Motif， Openwin， GTK 等图形界 面库和
Windows 平台上的 MFC， OWL， VCL， ATL 是同类型的东西。
—— 摘自：
http://baike.baidu.com/link?url=qTM13thOnHNc1TLEnlI30hW9NKZMFZ8_2IfhHBdJ0lBg4
5LPCRWbZ-1Q8K0N3zcWOsUp4zlDC9xaC90aD-GaBK
Qt 官网：
http://qt-project.org/
2. 从官网获取版本介绍
2.1 登录官网 http://qt-project.org/
2.2 单击左上角 Download
2.3 单击 Community 版本的 Download
这个版本是免费授权版本，其他版本需要授权费用
默认会根据你的操作系统，自动给你推荐一个版本，如目前笔者使用的 Windows7 操作系
统， 上图 Download Now 会提供 Qt Online Installer for Windows，我们一般使用离线安装
包，所以：
2.4 单击下方的 View All Downloads
出现各种版本的下载链接如图：
各个版本的使用，将在下面说明
2.5 版本说明
目前 Qt 最新版本是 5.4.0， 如果需要旧版本，可在 Other downloads 下的 Archive for old
versions 中寻找。
3. 各种操作系统下的安装说明
3.1 Fedora21 Linux 操作系统下的安装说明
Linux 下使用 g++进行编译
3.1.1 获取相应 Qt 版本安装包
根据系统内核位数，下载相应安装包：
 Qt 5.4.0 for Linux 32-bit (546 MB) (info)
 Qt 5.4.0 for Linux 64-bit (542 MB) (info)
如笔者使用的 Fedora 21 64bit 操作系统， 则下载 Qt 64bit 版本。
如果不知道自己的操作系统是 32 位还是 64 位，可用 uname –a 命令查询。如下图：
3.1.2 安装 qt-opensource-linux-x64-5.4.0.run
将下载的安装文件 qt-opensource-linux-x64-5.4.0.run 拷贝到 home/用户目录，如笔者使用的
/home/chenlei 目录。
如果 qt-opensource-linux-x64-5.4.0.run 的属性中拥有者没有运行权限，则可用 chmod 命令添
加执行权限：
然后执行./ qt-opensource-linux-x64-5.4.0.run，安装 Qt
下面一路点 next(下一步)安装就行了。安装路径可以修改，安装组件选择默认即可。
完成后见下图：
3.1.3 检查 g++是否安装
在终端(terminal)中输入 g++ -v，结果如下图说明 g++安装正确：
如果没有安装 g++，则通过 yum 命令安装：
1. 切换 root 权限： su
2. yum update
3. yum install gcc-c++
3.1.4 安装 libGL
1. 切换 root 权限: su
2. yum install libGL libGL-devel
3.2 Windows 下安装 MinGW 版本 Qt
Windows 下可以使用 GNU gcc/g++的 Windows 版本 MinGW 或使用微软的 Visual C++编译器。
安装 MinGW 版本 Qt 只需要一个安装文件，装完后使用 Qt Creator 作为 IDE。
3.2.1 下载 Qt MinGW 版本安装包
 Qt 5.4.0 for Windows 32-bit (MinGW 4.9.1, 852 MB) (info)
3.2.2 运行 qt-opensource-windows-x86-mingw491_opengl-5.4.0.exe 执行安装程序
此步骤与 Linux 下的安装步骤接近，一路点 next(下一步)安装就行了。安装路径可以修改，
安装组件选择默认即可。
安装后打开 Qt Creator
即可编写 Qt 程序。
3.3 Windows 下安装 vs 版本 Qt
该版本比较麻烦，需要获取三个安装文件。
3.3.1 获取安装文件
1. Visual Studio 安装包(如 cn_visual_studio_ultimate_2013_x86_dvd_3009109.iso)，可从微软
官网获取或搜索引擎获取，安装时要安装 vc++组件。 Vs 本身的安装本文不再介绍。
注意：有些版本的 Vs，微软在后期发布的有补丁，建议安装 vs 时，将所有补丁也装上。
2. Qt 5.4 for Windows vs 版本，根据自己的 vs 版本下载相应的版本，目前 Qt5.4 支持的 vs 环
境为 vs2013, vs2012, vs2010。点下面链接可以快速获取
 Qt 5.4.0 for Windows 64-bit (VS 2013, 720 MB) (info)
 Qt 5.4.0 for Windows 64-bit (VS 2013, OpenGL, 709 MB) (info)
 Qt 5.4.0 for Windows 32-bit (VS 2013, 704 MB) (info)
 Qt 5.4.0 for Windows 32-bit (VS 2013, OpenGL, 694 MB) (info)
 Qt 5.4.0 for Windows 32-bit (VS 2012, OpenGL, 643 MB) (info)
 Qt 5.4.0 for Windows 32-bit (VS 2010, OpenGL, 625 MB) (info)
选择相应版本号，在此说明一下，带 OpenGL 与不带 OpenGL 的区别，带 OpenGL 底层使用
OpenGL 作为 3D 引擎，不带的版本使用 d3d 作为 3d 引擎，但是多了一个 opengl 向 d3d 转
化的接口。 Opengl 是跨平台的 3d 引擎， Qt 封装了 OpenGL 以保证跨平台的兼容性。
下面都以 Qt 5.4.0 for Windows 64-bit (VS 2013, 720 MB)为例。
3. 获取 vs 插件
点下面链接可以快速获取
 Visual Studio Add-in 1.2.4 for Qt5 (156 MB) (info)
3.3.2 安装 Visual Studio
安装步骤不再赘述，注意选择 vc++组件，并安装补丁。
3.3.3 安装 Qt 5.4.0 for Windows 64-bit (VS 2013, 720 MB)
安装步骤参考前文，一路点 next(下一步)安装就行了。安装路径可以修改，安装组件选择默
认即可。
3.3.4 安装 vs 插件
由于我已装过，再点安装包就提示已安装了，所以这里就不截图了，安装步骤很简单。安装
完成后， vs 中多了 Qt5 菜单：
3.3.5 配置 Qt 版本
1. 点击上图中的 Qt Options
2. 点击 add 添加版本
3. 单击 ok，添加成功
3.3.6 编写 Qt 程序
1. 新建项目
2. 选择 Qt 应用程序，输入项目名称与路径
创建一个基于 QDialog 类的项目
3. 由于我安装的 64 位的 qt，所以关键的一步是修改平台为 x64
4. 切换 Qt 版本
鼠标右键单击 解决方案 选择上下文菜单中的 “ Change Solution’s Qt Version”
选择刚才配置的 64bit 版本的 Qt
如果是 32bit 的，则选择相应版本。
至此，可以正常编写 Qt 程序了。
4. FAQ
4.1 Qt Creator 中自动补全功能的开启
1. 选择工具->选项
2. 选择环境->键盘，输入 compl
3. 修改 CompleteThis 的快捷键
修改为 Alt+/（ eclipse 风格，也可自己设置为自己习惯的快捷键）
该命令默认快捷键为 Ctrl+Space，在 Windows 下与安装了 ibus 输入法的 Linux 下都与输入法
快捷键冲突，导致该功能失效，修改快捷键后即可使用。
4. 单击 Apply，然后点 OK 即可
4.2 vax 不识别 Qt 代码的解决办法
4.2.1 打开 vax 的选项
4.2.2 设置 C/C++ Directories 的 Platform 为 Custom。
4.2.3 此时的 New 变为可编辑状态，如下图：
单击 New 按钮，输入 Qt 安装目录下，对应版本的 include 文件夹目录，如图：
说明：
Stable include files，用于不常改变的头文件目录
Other include files，用于添加常改变的头文件目录
4.2.4 单击 Rebuild 并重启 vs 环境即可。
4.2.5 该方法适用于 VS 安装代码库如 boost,qt 等的 vax 识别。
参考 Vax 文档：
http://docs.wholetomato.com/default.asp?W213
4.3 VS 不识别 Qt 的头文件
问题描述及复现路径
创建 Qt 项目后，可能会出现不识别 Qt 的头文件的情况，一般在非 Qt 解决方案(创建的第一
个项目不是 Qt 项目)下创建 Qt 项目时出现。
解决办法
鼠标右键单击 解决方案 选择上下文菜单中的 “ Change Solution’s Qt Version”
选择一个版本即可
原因分析
创建 Qt 项目时， Qt 插件会在项目附加目录中添加 $(QTDIR)\include 如下图
这个$(QTDIR)是从解决方案继承过来的，如图：
对解决方案切换 Qt Version 后，解决方案的$(QTDIR)变量就会设置正确的值。
4.4 VS 中创建的 Qt 项目 Generated Files 文件夹中未生成文件
正常情况下：
但是有时却没有生成这些文件
解决办法
先对解决方案切换 Qt Version，然后再创建 Qt 项目
5. 后记
文中内容均为本人自己总结，所有应用都注明了出处。每日总结，分享快乐。希望能帮到更
多人。
作者：陈雷
日期： 2014-12-1