当前位置：首页 > news >正文

Qt 中的项目文件解析和命名规范

news 2026/5/12 15:15:26

🐌博主主页：🐌倔强的大蜗牛🐌

📚专栏分类：QT
❤️感谢大家点赞👍收藏⭐评论✍️

一、Qt项目文件解析

1、.pro 文件解析

2、widget.h 文件解析

3、main.cpp 文件解析

4、widget.cpp 文件解析

5、widget.ui 文件解析

二、Qt 编程注意事项

1、Qt 中的命名规范

2、Qt Creator 中的快捷键

3、使用帮助文档

一、Qt项目文件解析

1、.pro 文件解析

工程新建好之后，在工程目录列表中有一个后缀为 ".pro" 的文件， ".pro" 文件就是工程文件 (project) ，它是 qmake 自动生成的用于生产 makefile 的配置文件。

如图所示：

双击进入该文件，该文件的核心内容如下：

QT += core gui // Qt 包含的模块

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets //大于 Qt4 版本才包含 widget 模块

TARGET = QtFirst //应⽤程序名生成的 .exe 程序名称

TEMPLATE = app //模板类型，应用程序模板

SOURCES += main.cpp\ //源文件

widget.cpp //源文件

HEADERS += widget.h //头文件

2、widget.h 文件解析

在Qt中，如果要使用信号与槽（signal 和 slot）的机制就必须加入 Q_OBJECT 宏；

Ui::Widget *ui；这个指针是用前面声明的 namespace Ui 里的 Widget 类定义的，所以指针 ui 是指向可视化设计的界面，后面要访问界面上的组件，都需要通过这个指针 ui 去访问。

3、main.cpp 文件解析

使用 Qt Creator 新建任意工程之后，main.cpp 文件中都会自动生成如下代码：

#include "widget.h"#include <QApplication>int main(int argc, char *argv[])
{QApplication a(argc, argv);Widget w;w.show();return a.exec();
}

解释：

1. Qt 系统提供的标准类名声明头文件没有 .h 后缀；

2. Qt 一个类对应一个头文件，类名就是头文件名；

3. QApplication 为应用程序类；QApplication a；（a为应用程序对象，有且仅有一个）

QApplication 管理图形用户界面应用程序的控制流和主要设置。
QApplication 是 Qt 的整个后台管理的命脉。它包含主事件循环，在其中来自窗口系统和其它

资源的所有事件处理和调度。它也处理应用程序的初始化和结束，并且提供对话管理。
对于任何⼀个使用 Qt 的图形用户界面应用程序，都正好存在⼀个 QApplication 对象，而不论

这个应用程序在同一时间内是不是有 0、1、2 或更多个窗口。

4. myWidget w; //实例化窗口对象

5. w.show()； //调用show函数显示窗口

6. a.exec() ：程序进入消息循环，等待对用户输入进行响应。这里 main()把控制权转交给Qt，Qt 成事件处理工作，当应用程序退出的时候 exec() 的值就会返回。在 exec() 中，Qt 接受并处理用户

和系统的事件并且把它们传递给适当的窗口部件。

4、widget.cpp 文件解析

widget.cpp 文件是类 Widget 的实现代码，所有在窗体上要实现的功能添加在此文件中；

5、widget.ui 文件解析

widget.ui 是窗体界面定义文件，是⼀个 XML 文件，定义了窗口上的所有组件的属性设置、布局，及其信号与槽函数的关联等。用 UI 设计器可视化设计的界面都由 Qt 自动解析，并以 XML 文件的形式保存下来。在设计界面时，只需在 UI 设计器里进行可视化设计即可，而不用管 widget.ui 文件是怎么生成的。

二、Qt 编程注意事项

1、Qt 中的命名规范

类名：首字母大写，单词和单词之间首字母大写；
函数名及变量名：首字母小写，单词和单词之间首字母大写；
Qt 偏好驼峰命名法；

2、Qt Creator 中的快捷键

注释：ctrl + /

运行：ctrl + R

编译：ctrl + B

字体缩放：ctrl + 鼠标滑轮

查找：ctrl + F

整行移动：ctrl + shift + ⬆/⬇

帮助文档：F1

自动对齐：ctrl + i；

同名之间的 .h 和 .cpp 的切换：F4

生成函数声明的对应定义: alt + enter