Qt MDI开发实战：从零构建一个多文档编辑器（附完整源码）

Qt MDI开发实战：从零构建一个多文档编辑器（附完整源码）

如果你用过一些老牌的桌面软件，比如早期的Photoshop或者某些IDE，应该对那种能在一个主窗口里同时打开好几个文档窗口的界面不陌生。这种界面风格，就是MDI。如今，虽然单文档界面和标签页式界面更为流行，但在一些需要复杂工作流、多文档对比或特定行业软件中，MDI依然有其独特的价值。对于Qt开发者来说，QMdiArea组件就是构建这类应用的利器。但仅仅知道拖一个QMdiArea到界面上是远远不够的，如何优雅地管理子窗口的生命周期，如何让主窗口的工具栏与动态创建的子窗口无缝协作，如何处理文件操作带来的状态同步问题，这些才是实战中的真正挑战。

这篇文章，我将带你从零开始，手把手构建一个功能完整的MDI文本编辑器。我们不会停留在API用法的简单罗列，而是聚焦于一个可运行、可扩展的项目骨架，深入探讨那些官方文档可能一笔带过，但在实际开发中会让你头疼的细节。无论你是刚接触Qt不久，想找一个有深度的综合练习项目，还是已经有一定经验，希望系统掌握MDI应用架构的中级开发者，相信都能从中获得启发。我们将从项目创建、核心类设计，一直讲到窗口管理策略和高级功能集成，并提供可直接编译运行的完整源码。

1. 项目初始化与核心架构设计

在动手写代码之前，花点时间思考整体架构是值得的。一个典型的MDI应用包含几个核心部分：作为容器的主窗口、作为内容载体的子窗口、以及协调二者交互的控制器逻辑。在Qt中，这个容器就是QMdiArea。

首先，使用Qt Creator创建一个新的Qt Widgets Application项目。在MainWindow的UI设计器中，不要急于添加菜单或工具栏，我们先做最关键的一步：从左侧部件盒中找到Containers分类下的QMdiArea，将其拖拽到主窗口的中央区域。右键点击主窗口空白处，选择布局 -> 栅格布局，确保QMdiArea能随着窗口缩放而自适应。这一步奠定了MDI的视觉基础。

接下来，我们需要设计子窗口类。这个类将承载具体的文档内容和编辑功能。这里有一个关键决策：子窗口应该继承自QWidget、QMainWindow还是QMdiSubWindow？我推荐继承QWidget。原因如下：

• QMdiSubWindow本身是一个带有标题栏、最大化/最小化按钮的容器，它内部需要一个QWidget作为中心部件。如果我们直接继承QMdiSubWindow，反而限制了灵活性。
• QMainWindow过于重量级，它自带菜单栏、状态栏等，在MDI子窗口中通常不需要，而且可能与主窗口的控制逻辑产生冲突。
• QWidget最为轻量和灵活，我们可以完全控制其内部布局和功能，然后由QMdiArea的addSubWindow()方法将其包装成一个真正的MDI子窗口。

因此，我们新建一个Qt Designer Form Class，基类选择QWidget，命名为DocumentWindow。在它的UI文件中，我们放置一个QPlainTextEdit部件，并设置其布局为填充整个窗口。QPlainTextEdit相比QTextEdit，对于纯文本编辑性能更优，功能也更专注。

提示：在子窗口的构造函数中，记得调用setAttribute(Qt::WA_DeleteOnClose)。这确保了当子窗口关闭时，其C++对象会被自动删除，防止内存泄漏。这是Qt对象树机制和MDI生命周期管理协同工作的关键。

子窗口类的头文件需要声明一些公共接口，供主窗口调用：

// documentwindow.h
class DocumentWindow : public QWidget
{
    Q_OBJECT
public:
    explicit DocumentWindow(QWidget *parent = nullptr);
    bool loadFile(const QString &fileName);
    bool saveFile();
    bool saveAsFile();
    QString currentFile() const;
    bool isFileModified() const;
    // 编辑操作接口
    void cut();
    void copy();
    void paste();
    void setFont();

private:
    Ui::DocumentWindow *ui;
    QString m_currentFile;
    bool m_isUntitled = true; // 是否为未保存的新文件
};

这些接口构成了主窗口与子窗口通信的契约。主窗口的“打开”、“保存”、“剪切”等动作，最终都将委托给当前活动的DocumentWindow对象来执行。

2. 子窗口的生命周期与文件管理

子窗口的生命周期始于“新建”或“打开”动作，终于用户关闭它。管理好这个周期内的状态，是应用稳定的基础。

创建与添加子窗口：在主窗口的“新建”动作槽函数中，我们创建子窗口对象并将其添加到MDI区域。

void MainWindow::onActionNewTriggered()
{
    DocumentWindow *doc = new Document