1. 前言

.pro 文件是Qt的项目文件，里面包含了源文件路径、头文件路径、ui文件路径、资源文件路径、编译选项等诸多信息。当项目比较大时，软件中各个模块的代码文件路径、资源文件路径、编译选项都会写入到pro文件中，不仅导致pro文件会比较大，而且模块之间划分不清晰、耦合性强。如果想要移除、修改某个软件模块，则需要一番查找定位，非常不方便；同时，耦合性强可能会导致在修改某个模块时，错误修改了其他模块，影响其他模块的稳定性。解决此问题的方法，是使用pri文件对Qt项目分模块管理。模块化，是软件开发中老生常谈的技术了，使用pri对Qt项目分模块管理，还能提高软件模块的封装性和重用性。

2. 何为pri文件

pri文件是Qt项目中常用的子模块包含文件，可以认为是 project include 的缩写。它本质上是一个包含qmake指令脚本的纯文本文件，和pro文件语法相同，遵循qmake语法，但通常被pro或更上级的pri文件所包含。

下面讲解两种pri文件的应用。

3. pri文件的应用

3.1 使用pri文件将pro分解为子模块

未使用pri分解的Qt项目，项目结构及pro内容如下：

可以看到，在此项目中已经采取了初步的模块化措施，即将源代码文件按照功能分类，分别放到了不同的文件夹中。但是，当项目很大时，仅仅采用这种模块化措施是不够的，所有的源码路径、构建命令和编译选项都会全部写入到pro文件中，导致pro文件过大，模块划分不够清晰，难以维护。

使用pri对项目进行子模块分解，分解后项目结构及pro内容如下：

pri文件内容如下：

• Ui/Ui.pri

• Model/Model.pri

可见，使用pri将项目划分成子模块后，各个模块的相关内容，都移动到了各自的pri文件中，实现了解耦，便于管理。

3.2 使用pri封装程序库

通常，一个程序库（静态库，动态库）需要为使用者提供两种类型的文件：

• 头文件：头文件中定义了程序库相关的数据结构、被导出函数的签名等信息，供使用者包含后在程序编译期使用。
• 库文件：库文件用于将编译后的数据及代码，静态链接或动态链接到目标程序中，供使用者在程序链接及运行期间使用。

如果一个程序库的头文件和库文件很多，则使用者在将程序库导入到项目中时，需要编写很多头文件、库文件导入代码，以及添加很多头文件包含路径。在Qt中，库的导入过程包含的所有指令，可以使用pri文件完整地封装起来。使用者在使用时，只需要包含程序库的pri文件即可。

以自定义的图表程序库 MyChart 为例。MyChart库根目录内容如下：

其中，include文件夹用于存放库的头文件，内容如下：

lib目录用于存放库文件，内容如下：

不使用 pri文件，直接将库导入到 pro 文件中，需要在项目的pro文件中添加导入指令，如下图红色框中所示：

若采用pri的方式导入程序库，只需要将导入指令稍作修改，写入到pri文件中，并将pri文件作为程序库的一部分提供给使用者，使用者包含此库提供的pri文件即可。下面开始演示。

首先在程序库根目录下，新建空文本文件，重命名为MyChart.pri：

然后，使用文本编辑器编辑MyChart.pri文件，内容如下：

其中，$PWD的值，等于当前pri文件所在目录的绝对路径，必须要基于此目录相对寻址其他路径，否则极容易出现路径错误的问题，读者可以自己尝试。

最后，我们这里将MyChart程序库文件夹拷贝到Test测试项目的根目录下，使用include指令包含MyChart.pri，即可将程序库导入到当前项目：

至此程序中可以正常使用MyChart程序库。

可见，使用pri封装程序库，可以极大的简化程序库的导入过程，实现程序库导入指令的完美复用。不仅如此，在我们需要从工程中移除某个程序库时，也非常简单，只需要从项目中删除相应的程序库导入指令即可。

4. 结语

本质上，pri文件的使用属于模块化技术。pri文件的使用在实际项目中使用很多，而在官方文档和很多教材中往往讲解较少。和pri文件相关的问题多数是优劣问题，而不是对错问题。当项目越来越大、越来越复杂时，使用pri文件管理项目子模块，是提高项目的可维护性、降低项目风险、减少工作量、保证项目进度的重要技术手段。

本文原创发布于Qt未来工程师。