桌面应用 / 系统课时

看懂 Qt 工程目录与文件

看懂 Qt 工程目录与文件

本篇帮助你理解一个 Qt 6 项目中常见文件的职责,知道 CMake 配置、入口代码和窗口类如何协作,从而能够快速定位代码位置并修改桌面应用。

学习目标

  • 了解 Qt 工程中主要文件的职责和组织方式。
  • 理解 main.cpp、窗口类头文件与源文件之间的关系。
  • 能够根据项目结构判断新增功能应该放在哪个文件中。

Qt 项目的基本组成

一个 Qt 6 桌面项目通常由构建文件、程序入口、界面类以及资源文件组成。文件数量可能随着项目规模增加,但职责划分通常保持稳定。

常见结构如下:

文件 作用
CMakeLists.txt 描述项目构建规则、依赖和目标程序
main.cpp 程序启动入口,创建应用对象并显示窗口
窗口类头文件(如 mainwindow.h) 声明窗口类、成员变量和函数
窗口类源文件(如 mainwindow.cpp) 实现窗口行为和业务逻辑
.ui 文件 使用 Qt Designer 保存界面布局
资源文件(如 .qrc) 管理图片、图标等静态资源

理解这些职责后,修改 Qt 应用时就不会把所有代码都堆积到入口文件中。

程序入口 main.cpp 的职责

Qt 应用启动时需要创建 QApplication 对象,并创建顶层窗口。main.cpp 通常只负责启动流程,不应该包含复杂业务逻辑。

cpp
#include <QApplication>
#include "mainwindow.h"

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    MainWindow window;
    window.show();

    return app.exec();
}

这段代码完成三个动作:初始化 Qt 运行环境、创建窗口对象、进入事件循环。按钮点击、窗口刷新等行为会在事件循环中持续处理。

预期输出

text
启动 Qt 应用后显示一个主窗口,关闭窗口后程序退出。

窗口类的头文件与源文件

Qt 中常用类拆分方式是将接口声明和实现分离。例如窗口类通常包含两个文件:

mainwindow.h 声明窗口有哪些能力:

cpp
#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>

class MainWindow : public QMainWindow
{
public:
    explicit MainWindow(QWidget *parent = nullptr);
};

#endif

mainwindow.cpp 负责具体实现:

cpp
#include "mainwindow.h"

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    setWindowTitle("Qt 6 Demo");
}

预期结果

text
运行程序后,窗口标题显示为 Qt 6 Demo。

这种拆分方式让界面声明、事件处理和业务代码更加容易维护。

如何判断代码应该放在哪里

开发 Qt 应用时,可以根据职责选择文件:

  • 修改窗口初始化逻辑,通常放在窗口类构造函数中。
  • 增加按钮点击处理,通常放在窗口类源文件中。
  • 修改依赖模块或编译选项,修改 CMakeLists.txt。
  • 控制程序启动流程,修改 main.cpp。

不要把业务逻辑全部写进 main.cpp,否则项目增长后会难以维护。

常见项目维护误区

初学者经常把所有代码写在入口文件中,导致窗口创建、数据处理和界面控制混杂。Qt 的类设计鼓励按照对象职责拆分代码,让每个文件只负责一类问题。

当项目从单窗口扩展到多个页面时,清晰的目录结构会明显降低后续修改成本。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

看懂 Qt 工程目录与文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通