前言

笔者在工作中了解到，有部分同学对Qt的项目文件，即.pro文件的基本配置编写不是很了解。作为一名Qt工程师，.pro文件的编写也是必会的技能，本文对此进行一个讲解，并将相关资料做一个汇总。

.pro文件的介绍

.pro文件是Qt的项目文件，Qt允许我们直接编辑，不像Visual Studio基本上所有项目选项都需要界面来配置。 Qt使用其自带的qmake.exe来解析.pro文件。.pro文件有自己的语法规则，所以学习起来需要一定的成本。目前我们只需要学习编写最基本的配置即可，根据二八定律，80%的情况下，我们只能用到20%的配置方法，剩余20%的情况等到我们熟悉了.pro文件以后，再去查询解决即可。二八定律学习法一定要牢牢掌握哦！

一个.pro文件的例子

打开Qt，新建一个Qt Widgets Application。笔者使用的Qt Creator版本是Qt Creator 4.0.2。 下面是.pro文件中的内容

#-------------------------------------------------
#
# Project created by QtCreator 2021-08-20T09:56:45
#
#-------------------------------------------------

QT       += core gui

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

TARGET = untitled13
TEMPLATE = app

SOURCES += main.cpp\
        mainwindow.cpp

HEADERS  += mainwindow.h

FORMS    += mainwindow.ui

下面依次解释上面的代码各行的含义

• QT += core gui

指定当前项目使用的Qt模块，Qt会自动将相关模块的头文件、库文件加入到项目配置中。只有在.pro中指定了需要使用的库，才能在项目中使用相关的功能。 比如使用网络时：QT += network；使用xml时：QT += xml，等等。 「新问题：」 如何知道某个Qt类在哪个库呢。在Qt手册中找到对应的类，有类所在库的信息，如下图：

• greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

此行的含义为：当前Qt的版本大于Qt4的话，即Qt5的话，就加入widgets模块。可见widgets模块可能是Qt5中才引入的。

• TARGET = untitled13

目标程序名称。就是生成出来的目标文件的文件名前缀，不包含扩展名，扩展名由项目类型决定。这里指定了untitled13，如果项目类型是应用程序，则会生成untitled13.exe；如果项目类型是动态库，则会生成untiled13.dll文件。

• TEMPLATE = app

指定项目模板类型，也就是项目类型。可以指定app（应用程序）、lib（库），除了这些还有其他类型，Qt文档的qmake manual部分有详细描述。

• SOURCES += main.cpp mainwindow.cpp

指定源代码文件列表

• HEADERS += mainwindow.h

指定头文件列表

• FORMS += mainwindow.ui

指定ui设计文件列表

其他常用配置项

• DESTDIR = $PWD/

此行代码用于指定目标文件的保存目录。 DESTDIR是英文Destination Directory的缩写，即目的文件夹。 $PWD是一个保存当前目录路径的变量。

• LIBS += -L$PWD/

此行代码同Visual Studio中的“附加库目录”功能，用于添加库文件搜索路径。

• LIBS += -lmylib

此行代码同Visual Studio中的“附加依赖库”功能，用于添加需要链接的库文件。可以和上面的添加库文件搜索路径写在一起，比如 LIBS += -L$PWD -lmylib。

• CONFIG += staticlib

结合TEMPLATE = lib使用，指定生成静态库。

• CONFIG += dll

结合TEMPLATE = lib使用，指定生成动态库。

• INCLUDEPATH += $PWD

用于添加头文件的包含目录。和Visual Studio中的“附加包含目录”功能一致。

• DEFINES += MY_MACRO

用于添加全局需要使用的宏定义。和Visual Studio中的“预处理器定义”功能一致。

• TRANSLATIONS += en_zh.ts

指定翻译文件。关于翻译文件会在国际化的相关文章中说明。

• message($PWD)

message是.pro中的内置函数，用于打印消息或变量，一般用于调试变量或步骤是否正确。 输出的消息会在Qt Creator底部的“概要信息”中打印。

• 配置判断

CONFIG(debug, debug | release) {
	# 这里写debug下的配置内容，最常见的用法是链接debug版本第三方的库
} else {
	# 这里写release下的配置内容，最常见的用法是链接release版本第三方的库
}

• include(sub_module.pri)

这个非常重要。.pri是子模块配置文件，编写方式和.pro基本一样。不一样的地方就在于，它毕竟是子模块配置文件，只需要写子模块的配置信息即可，不需要写诸如 TEMPLATE = app等这种应该在pro文件中编写的配置项。 有的同学会问，.pri文件在哪创建？界面上怎么找不到？这个确实笔者也一直都没有找到，需要自己新建一个文件，将文件后缀改为.pri，最后在.pro文件中使用include包含进来。 .pri的典型用法这里举一例：用来引入第三方库。一般第三方库需要提供头文件、库文件。想要引入到Qt项目中，编写一个.pri文件就比较简单，需要用到的项目直接include这个.pri文件即可。相对于Visual Studio需要到多个界面配置第三方库，简单了很多。一个引入库的pri子模块文件内容如下图所示：

其他说明项

• 经测试，构建一次项目.pro文件可能会被执行多次。所以不能认为.pro构建一次，只执行一次，这和我们想得不太一样，需要注意。

参考资料

当然是官方手册了，在Qt Assistant中，切换到“索引”，输入“qmake manual”即可找到。

结语

学会使用.pro文件真的很重要，一定要掌握最基本的配置。 后续如果有其他比较重要的配置项，会更新说明，敬请关注。

本文首发自微信公众号“Qt未来工程师”。