Qt应用如何架构以避免所有槽函数集中在MainWindow类

我完全懂你的感受——把所有槽函数和信号连接都堆在MainWindow里，虽然能直接操控UI控件，但代码越写越臃肿，维护起来简直是噩梦。针对你频繁操作QSlider、QTextEdit、QFormLayout，还要同步QGLWidget状态的场景，这里有几个实用的架构思路，能帮你拆分代码同时保持开发便捷性：

1. 控件分组封装：把相关控件与逻辑打包成自定义类 #

把功能强相关的控件（比如一组控制QGLWidget渲染参数的QSlider+QTextEdit）封装成自定义Widget，内部处理自身的信号槽逻辑，只对外暴露核心的状态变化信号。这样MainWindow只需要处理跨组件的交互，不用再维护一堆零散的控件连接。

举个具体例子，你可以创建一个RenderSettingsWidget：

// rendersettingswidget.h
class RenderSettingsWidget : public QWidget {
    Q_OBJECT
public:
    explicit RenderSettingsWidget(QWidget *parent = nullptr);
    // 对外提供获取当前参数的接口
    RenderParams currentParams() const;
signals:
    // 仅对外暴露核心状态变化信号
    void settingsChanged(const RenderParams &params);
private slots:
    // 内部处理控件的信号
    void onSliderValueChanged(int value);
    void onTextEditEdited();
private:
    // 内部同步参数并发送通知
    void updateParamsAndNotify();
    // 自定义Widget内部直接管理控件
    QSlider *m_resolutionSlider;
    QTextEdit *m_resolutionText;
    RenderParams m_currentParams;
};

在MainWindow里只需要一行连接就能搞定交互：

connect(m_renderSettingsWidget, &RenderSettingsWidget::settingsChanged, 
        m_glWidget, &MyGLWidget::updateRenderParams);

2. 用QDataWidgetMapper简化表单控件与数据模型的绑定 #

你用到大量QFormLayout，说明很多控件是用来编辑一组结构化数据的。这时候用QDataWidgetMapper可以自动完成控件与数据模型的绑定，完全省去手动编写每个控件的valueChanged连接代码。

首先定义一个承载配置数据的QObject子类：

class RenderConfig : public QObject {
    Q_OBJECT
    // 用Q_PROPERTY暴露可绑定的属性
    Q_PROPERTY(int resolution READ resolution WRITE setResolution NOTIFY resolutionChanged)
    Q_PROPERTY(double scale READ scale WRITE setScale NOTIFY scaleChanged)
public:
    int resolution() const { return m_resolution; }
    void setResolution(int res) {
        if (res != m_resolution) {
            m_resolution = res;
            emit resolutionChanged(res);
        }
    }
    // 其他属性的getter/setter
signals:
    void resolutionChanged(int);
    void scaleChanged(double);
private:
    int m_resolution = 1080;
    double m_scale = 1.0;
};

然后在MainWindow里完成映射绑定：

RenderConfig *m_renderConfig = new RenderConfig(this);
QDataWidgetMapper *mapper = new QDataWidgetMapper(this);
// 绑定数据对象
mapper->setRootObject(m_renderConfig);
// 关联控件与对应属性
mapper->addMapping(m_resolutionSlider, 0); // 对应resolution属性
mapper->addMapping(m_scaleSlider, 1);     // 对应scale属性
// 启动映射
mapper->toFirst();

// 仅需要监听数据模型的信号来更新QGLWidget
connect(m_renderConfig, &RenderConfig::resolutionChanged, 
        m_glWidget, &MyGLWidget::setResolution);
connect(m_renderConfig, &RenderConfig::scaleChanged, 
        m_glWidget, &MyGLWidget::setScale);

3. 引入事件总线模式彻底解耦组件 #

如果控件与QGLWidget的交互逻辑复杂，或者未来需要扩展更多控件，事件总线模式可以彻底解耦各个组件，MainWindow甚至不用参与任何连接逻辑。

先实现一个简单的单例事件总线：

// EventBus.h
class EventBus : public QObject {
    Q_OBJECT
public:
    static EventBus& instance() {
        static EventBus instance;
        return instance;
    }
    // 模板方法发送任意类型事件
    template<typename EventType>
    void postEvent(const EventType &event) {
        emit eventPosted(QVariant::fromValue(event));
    }
signals:
    void eventPosted(const QVariant &event);
private:
    EventBus() = default;
};

然后在自定义Widget里发送事件：

void RenderSettingsWidget::updateParamsAndNotify() {
    RenderParamsChangedEvent event(m_currentParams);
    EventBus::instance().postEvent(event);
}

最后在QGLWidget里监听并处理事件：

MyGLWidget::MyGLWidget(QWidget *parent) : QGLWidget(parent) {
    connect(&EventBus::instance(), &EventBus::eventPosted, 
            this, &MyGLWidget::handleEvent);
}

void MyGLWidget::handleEvent(const QVariant &event) {
    if (event.canConvert<RenderParamsChangedEvent>()) {
        auto paramsEvent = event.value<RenderParamsChangedEvent>();
        updateRenderParams(paramsEvent.params());
    }
    // 可扩展处理其他事件
}

4. 利用Qt自动连接减少手动连接代码 #

如果不想彻底重构，但想减少重复的connect代码，可以用Qt的自动连接机制：只要槽函数命名符合on_<控件objectName>_<信号名>的格式，Qt会自动帮你完成连接。

比如你的滑块objectName是resolutionSlider，直接在MainWindow里写：

private slots:
    void on_resolutionSlider_valueChanged(int value);

Qt会自动把resolutionSlider->valueChanged(int)信号连接到这个槽函数，省去手动编写connect的步骤。不过这个方法更适合简单逻辑，复杂场景还是建议用前面的封装方案。

内容的提问来源于stack exchange，提问作者linello