Qt学习笔记3:Qt工程的目录结构

时间:2022-04-02 05:22:35

经过前两篇的学习,已经可以使用Qt空项目模板创建自己的工程了。通过本篇的学习,整理一下如果使用Qt工程的目录结构,使项目更规范和容易管理。

当前的目录结构

如图所示,这是前篇中创建的工程,只有main.cpp和widget.cpp、widget.h三个文件,直接放在了一个目录下,没有子目录:

Qt学习笔记3:Qt工程的目录结构

在向工程中添加新文件时,默认情况下,都是自动创建到当前目录下。工程文件比较少时不会影响使用,但是当文件多起来,工程就变的难以管理,这个时候,再去整理文件就变得麻烦。所以,好的工程,应该在最开始构建项目时,就将工程的目录结构创建好。下面,我们来介绍一下怎样创建Qt工程的目录结构。

使用Qt工程的目录结构

当我们的工程下需要分目录管理文件时,可以通过以下两种方式实现:

  • 使用子目录路径
  • 使用pri文件

接下来我们对这两种方式分别介绍,可自行选择。

使用子目录路径

在向工程添加或新创建文件时,创建子文件,并将文件创建在子目录下。

Qt学习笔记3:Qt工程的目录结构

将创建的类放在子目录下,完成后,效果如图所示:

Qt学习笔记3:Qt工程的目录结构

在pro文件中自动加入了src/widget.h和src/widget.c两个文件,都是使用相对路径的方式。
以这种方式的子目录,在使用时,头文件的引用也要加上相对路径,否则会出现找不到文件的错误。或者再pro文件中添加环境变量:

INCLUDEPATH += src

可以正常使用。Qt工程会自动将新增的文件分类放在头文件和源文件两个目录下。在实际目录下是没有这两个文件夹的,但是看着特别别扭。

使用pri文件

第二种方式,使用pri文件。关于pro、pri、prf、prl文件在Qt的用途和使用方法,可以自行学习。
pri文件的作用,这里是将pro文件的一部分放入每个路径下的pri文件,分别管理,最后在将pri文件包含到pro中即可。使用方法:

(1)手动创建pri文件
手动创建子目录,并创建空文件或文本文件,将文件后缀改为pri。
注意,pri文件的文件名就是Qt工程显示的子目录名,而不是实际手动创建的子目录,这里建议将pri的文件名和子目录名保持一致。

(2)包含pri文件
在pro文件中包含pri文件,使用include命令

include(src/src.pri)

保存后,Qt工程会自动将pri文件添加到工程中,并显示子目录

Qt学习笔记3:Qt工程的目录结构

(3)添加新文件
右键选择子目录,点击添加新文件或者创建文件,完成后如图所示:

Qt学习笔记3:Qt工程的目录结构

Qt工程会自动向子目录下的pri工程文件添加文件,并将文件信息自动写入pri文件。

Qt学习笔记3:Qt工程的目录结构

使用这种方法,不需要增加INCLUDEPATH环境变量,不会出现找不到头文件的问题。

如何去除Qt文件自动分类Sources和Headers

当前我使用的Qt版本是5.6,查了一下资料,发现最新版本在创建或者添加文件时,都会自动对文件进行分类,显示Sources和Headers目录下。
尝试了几种办法,都无法去除自动分类。在CSDN论坛发帖问了一下,据说是改不了。倒是不影响使用,不知道后续的版本这个地方会不会有变化。