Qt的安装和使用中的常见问题（详细版）

对于太长不看的朋友，可参考Qt的安装和使用中的常见问题（简略版）。

目录

• 1、引入
• 2、Qt简介
• 3、Qt版本
  • 3.1 查看安装的Qt版本
  • 3.2 查看当前项目使用的Qt版本
  • 3.3 查看当前项目使用的QtCreator版本
  • 3.4 Linux命令行下查看和使用不同版本的Qt
• 4、Qt模块
• 5、引用头文件报错

---

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文件里写入了
INCLUDEPATH += \ function \ ui
那么，在项目的任何文件里，引用/project/function/function1.h或者/project/ui/mywindow.h时，都可以直接写#include "function1.h"和#include "mywindow.h"

---

---

谢谢关注
未完待续