正文
Qt的安装和使用中的常见问题（详细版）
提示：扫一扫查出行【扫一扫了解最新限行尾号】
复制提示
对于太长不看的朋友，可参考Qt的安装和使用中的常见问题（简略版）。
目录
-
1、引入
-
2、Qt简介
-
3、Qt版本
-
3.1 查看安装的Qt版本
-
3.2 查看当前项目使用的Qt版本
-
3.3 查看当前项目使用的QtCreator版本
-
3.4 Linux命令行下查看和使用不同版本的Qt
-
4、Qt模块
-
5、引用头文件报错
- 3.1 查看安装的Qt版本
- 3.2 查看当前项目使用的Qt版本
- 3.3 查看当前项目使用的QtCreator版本
- 3.4 Linux命令行下查看和使用不同版本的Qt
## 1、引入
对于Qt的初学者来说，Qt有很多不熟悉的地方，安装和使用时，都会遇到各种各样的“坑”。这些坑，如果经历过一次，就会发现其实是很简单的问题。但是如果不熟悉，那么可能折腾很久也没解决。因此我把我自己遇到的（也是后来常常被问到的）一些问题放在这里，供大家参考、讨论。
这个版本写得详细一些，适合喜欢了解细节的朋友。对于太长不看的朋友，可参考Qt的安装和使用中的常见问题（简略版）。
## 2、Qt简介
Qt是一款基于C++的跨平台开发框架，不仅提供了便捷好用的图形库，而且提供的框架比C++本身更好用（个人感觉）。
Qt和QtCreator
有些人可能会把Qt和QtCreator弄混，但是这两个是不同的概念。
- Qt：跨平台开发框架，包括图形库、其他功能库（多媒体、网络等）以及对C++的扩展。
- QtCreator：专为使用Qt框架开发的集成开发环境（IDE）。QtCreator本身基于Qt框架开发的。
QtCreator不是Qt，它运行起来只需要部分Qt库，所以QtCreator能运行，根本不代表Qt所有模块已经被完整安装了。
## 3、Qt版本
开发时经常涉及Qt版本问题，因为最新的版本可能提供更多的功能，但是有些以前的代码是用旧版本写的，因此要特别注意自己的版本。
### 3.1 查看安装的Qt版本
一般情况下，你下载了比如说Qt 5.8的安装包，安装之后，Qt的版本自然是5.8。但是，假如你安装了多个版本的Qt，情况就复杂一点。事实上，你可以在QtCreator选择对当前的项目使用哪个版本的Qt来构建。
下面是查看Qt版本的方法：
菜单栏 -> 工具（Tools） -> 选项（options）
左侧边栏里，选中“构建与运行（Build & Run）”，然后注意看右侧上部的标签，有构建套件（kit）、Qt版本（Qt Versions）、编译器（compiler）、调试器（Debugger）等。
构建套件指的是一些用来构建你编写的代码的工具组合。这个组合里主要包括三个东西：qmake工具、编译器、调试器。
不同的组合就是不同的构建套件。你可以看到你的默认套件是哪个。当你打开一个之前没有打开过的Qt项目，或者新建一个Qt项目时，QtCreator都会让你选择一个套件，而默认的就是这里显示的默认套件。
点击任意一个套件，就能看到详情：
这里，注意其中有一项叫做 Qt版本（Qt version） 。可以看到，我这里的是Qt5.8。
这就意味着，当你使用这个套件的时候，你使用的Qt版本是5.8。当然，这个套件的名字里写了是5.8.0，不过要注意的是，手动设置的套件名字可以任意取，所以还是要点进去确认一下。
我这里就装了两个版本的Qt，分别是5.7和5.8，所以这里能看到另一个套件对应的Qt版本是5.7。
前面说了，这个套件是一个组合，不一定就包含了你的计算机上所有的Qt版本。怎么知道计算机上有哪些Qt版本可用呢？
这就需要切换到 Qt版本（Qt Versions） 页面了。
这里就能看到所有已经自动检测到的，或者手动配置的Qt版本。细心的朋友已经发现了，每一个Qt版本后面，对应的是一个qmake.exe（Linux下没有后缀，就是qmake）。
没错！决定你所使用的Qt版本的就是qmake工具的版本！Qt项目一般都是用qmake来管理的（按照默认配置新建Qt项目，就是这样），而每次构建之前，qmake都会执行，其中有个重要的任务就是告诉后续的编译器，应该用哪个版本Qt库来编译这些程序。
所以，前面说的套件里的Qt版本，其实就是这个套件使用的qmake的版本。而套件里的编译器和调试器等等，与你使用的Qt版本关系不大。
### 3.2 查看当前项目使用的Qt版本
有个项目的代码最初打开的时候没留意用的套件和版本，或者代码是从别人那里拷贝过来的，我怎么知道是用的哪个版本呢？
方法很简单！在QtCreator里打开这个项目，然后在最左侧的栏目里，切换到 项目（Project） ：
因为QtCreator版本不同，所以你的界面可能跟我不一样。不过没关系，关键东西都在。找到 Build & Run ，然后就能看到这个项目正在使用的是什么套件以及什么Qt版本了。
例如，我这个项目使用的构建套件名称是Qt 5.8.0 (mingw53_32)，对应的Qt版本是5.8.0。
### 3.3 查看当前项目使用的QtCreator版本
前面说了Qt和QtCreator是不同的。Qt有版本，QtCreator作为一款软件也有版本。在QtCreator菜单 -> 帮助 -> 关于QtCreator就可以查看了。
例如这里，我的QtCreator的版本是4.2.1，是基于Qt5.8.0开发的。
### 3.4 Linux命令行下查看和使用不同版本的Qt
如果在Linux命令行下使用，例如编译一些简单程序或第三方库，可以不需要启动QtCreator，直接在命令行中编译。这种情况，一般要求先执行```qmake```，再执行```make```。而执行```qmake```时就决定了使用哪个版本的Qt，要特别注意。
所以在不确定的情况下，应该使用
qmake -v
来查看Qt版本。如果执行之后发现版本不对，想用其他版本。那么需要找到你想用的版本对应的qmake执行文件在哪里。这个会复杂一些，下面简单说一下。
1、如果安装了多个版本的Qt，用
find
指令或者其他方式搜索qmake执行文件，并且检查一下搜索到的qmake分别对应什么版本的Qt。注意针对搜索到的qmake，使用时要带完整路径，例如
$ sudo find / -name qmake # 查找名为qmake的文件
/home/XYZX/Qt5.8.0/5.8/gcc_64/bin/qmake # 这个是举例
$ /home/XYZX/Qt5.8.0/5.8/gcc_64/bin/qmake -v # 查看某个找到的qmake是什么版本
之后如果要使用这个特定的qmake，那么编译的时候不能只输入
qmake
了，而是要有完整路径，和上面查看版本的时候一样：
$ /home/XYZX/Qt5.8.0/5.8/gcc_64/bin/qmake
$ make
2、设置默认的qmake
注意
：我给出的目录是我的情况，并非通用，不同系统上的路径可能不同，但是大同小异，也可以通过搜索查看。
默认的qmake就是在命令行里直接输入
qmake
时使用的。用
which qmake
可以看到对应的文件是
/usr/bin/qmake
。
用
ls -l /usr/bin/qmake
指令可以发现这个其实是个连接，指向的是
/usr/bin/qtchooser
。也就是由这个“选择器”来选择版本的。选择的依据是配置文件。
该配置文件是：
/usr/lib/x86_64-linux-gnu/qt-default/qtchooser/default.conf
。而进一步可以发现此文件仍然只是一个链接，如果要修改默认qmake，则需要修改此链接指向的具体文件。
例如，我的电脑上，该文件指向的是
/usr/share/qtchooser/qt4-x86_64-linux-gnu.conf
。
等等……我还在用Qt4？不不不……不要被文件名骗了，一定要打开文件查看一下！以下是我电脑上
/usr/share/qtchooser/qt4-x86_64-linux-gnu.conf
的内容：
/home/xyzx/Qt5.8.0/5.8/gcc_64/bin
#/usr/lib/x86_64-linux-gnu/qt4/bin
#/usr/lib/x86_64-linux-gnu
#/home/xyzx/Qt5.8.0/5.8/gcc_64/bin/qmake
不出意外的话，#开头的都是注释。那么有效的就是第一句话了，看来用的
/home/xyzx/Qt5.8.0/5.8/gcc_64/bin
里的qmake，其实是Qt5.8.0版本。
而与这个文件同级目录下（即
/usr/share/qtchooser/
）还可能有其他的同类文件。确认要使用哪个配置文件后，将链接
/usr/lib/x86_64-linux-gnu/qt-default/qtchooser/default.conf
指向这个文件即可，例如
sudo ln -sf /usr/share/qtchooser/qt4-x86_64-linux-gnu.conf /usr/lib/x86_64-linux-gnu/qt-default/qtchooser/default.conf
再次提醒 ：我这里写的目录可能跟你的实际情况不同。
## 4、Qt模块
Qt框架是由多个模块构成的。最核心的是QtCore，也是必须的。如果不使用这个核心模块，那其实是在用纯C++编程，跟Qt无关了。其他模块还有：
+ GUI 图形界面
+ Multimedia 多媒体
+ Network 网络功能
+ SQL 数据库
这里只列举了部分。
在使用Qt编程时，有两个常见问题。
问题1：
用QtCreator打开项目时提示：Unknown module(s): XXXX
原因：提示的那个Qt模块，你电脑上没有安装。一般是在Linux上通过apt来安装Qt，之后发现这个问题。因为你没有安装所有Qt模块。正如前面所说的，不是说QtCreator能运行，就意味着你的Qt装完整了。
解决办法就是安装这个模块。如果使用apt或synaptic安装软件包，如何查找呢？对于Qt5版本，Qt模块的软件包名称有规律，都是
libqt5
开头的，后面跟模块名称。例如Qt5核心模块的软件包是
libqt5core5a
，GUI模块的软件包是
libqt5gui5
。后面可能会跟不同后缀。
有一个例外（就我目前遇到的），是multimedia。除了刚才说的包之外，你可能还需要安装
qtmultimedia5-dev
。
对于缺少模块的情况，一般安装
libqt5
+模块名的包就可以了。安装完成后需要重新打开QtCreator。
如果安装完后还是不行，那么可以将名称相关的包都安装试试。
问题2：
引用一个Qt的头文件，结果提示：No such file or directory: QXXXX.h
原因：你没有在你的项目里引入这个模块。
解决方法很简单，在.pro文件中加入这个模块。添加位置是开头的
QT += ...
后面。例如，你想引用
QTcpServer.h
，首先在帮助里查找
QTcpServer
类，看到它属于network模块，再引入这个模块。如果QtCreator里打不开帮助，也可以在网页上搜索，因为Qt官方网站提供了帮助文档。
例如这一行原本如下，表示使用了core和gui两个模块。
QT += core gui
新增network模块：
QT += core gui network
注意：全小写，用空格与之前的隔开。
## 5、引用头文件报错
**问题1**：引用一个自己的头文件，.h文件已经存在于项目文件夹里了，但是编译时报错：No such file or directory: XXXX.h
原因：文件没有加入项目。去.pro文件里查看，这个头文件是否已经加入到headers列表里。如果没有加入的话，也不用自己敲键盘把文件名写到列表里，直接对项目名点击鼠标右键，再点击“添加已有文件”，选择报错的文件（包括没有加入sources列表的cpp文件）。
问题2
：引用一个头文件，.h文件存在且已经加入项目，但是编译时还是报错：No such file or directory: XXXX.h
问题：引用路径错误。对于一些复杂一点的项目，不同功能的代码是放在不同的文件夹下的。引用时确保写上了头文件的相对路径。你在哪里引用就相对于谁。
例如，有一个头文件位于
/project/function/function1.h
，而此时你编辑的文件是
/project/ui/mywindow.h
，那么引用时的写法是：
#include "../function/function1.h"
。
另外，.pro文件里可以加入一个
INCLUDEPATH +=
，可以自定义引用搜索路径。如果在.pro文件里写入了
function \
ui
那么，在项目的任何文件里，引用
/project/function/function1.h
或者
/project/ui/mywindow.h
时，都可以直接写
#include "function1.h"
和
#include "mywindow.h"
谢谢关注
未完待续
