如何不大量修改代码捕获Qt应用所有信号以记录用户交互行为

无需修改原有业务代码，可通过以下两种成熟方案实现需求： #

方案1：全局事件过滤器（改造成本最低） #

利用Qt全局事件过滤机制捕获所有用户交互事件，仅需新增一个日志类，在main函数中新增2行代码即可完成接入。

实现步骤 #

1. 新增交互日志类，继承QObject并重写eventFilter方法，按需处理不同类型的交互事件，写入日志文件。
2. 在main函数中给QApplication实例安装该全局事件过滤器，原有业务逻辑完全不需要改动。

示例代码 #

#include <QObject>
#include <QEvent>
#include <QAbstractButton>
#include <QLineEdit>
#include <QFile>
#include <QDateTime>
#include <QTextStream>
#include <QApplication>

class InteractionLogger : public QObject
{
    Q_OBJECT
public:
    explicit InteractionLogger(QObject *parent = nullptr) : QObject(parent) {
        m_logFile.setFileName("user_interaction.log");
        m_logFile.open(QIODevice::Append | QIODevice::Text);
    }

protected:
    bool eventFilter(QObject *watched, QEvent *event) override {
        // 捕获按钮点击
        if (event->type() == QEvent::MouseButtonRelease && qobject_cast<QAbstractButton*>(watched)) {
            auto *btn = qobject_cast<QAbstractButton*>(watched);
            writeLog(QString("按钮点击 | 控件名：%1 | 显示文本：%2").arg(btn->objectName(), btn->text()));
        }
        // 捕获输入框编辑
        else if (event->type() == QEvent::KeyRelease && qobject_cast<QLineEdit*>(watched)) {
            auto *edit = qobject_cast<QLineEdit*>(watched);
            writeLog(QString("输入框编辑 | 控件名：%1 | 当前内容：%2").arg(edit->objectName(), edit->text()));
        }
        // 可按需扩展下拉框选择、复选框勾选等其他交互事件的处理逻辑
        return QObject::eventFilter(watched, event);
    }

private:
    QFile m_logFile;
    void writeLog(const QString& content) {
        QTextStream out(&m_logFile);
        out << QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss.zzz ") << content << "\n";
        out.flush();
    }
};

main函数接入逻辑：

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    // 新增两行代码接入日志
    InteractionLogger *logger = new InteractionLogger;
    a.installEventFilter(logger);
    // 原有业务逻辑完全不变
    MainWindow w;
    w.show();
    return a.exec();
}

方案2：元对象系统自动绑定信号 #

如果需要精确捕获控件的交互信号而非系统事件，可利用Qt元对象系统递归遍历所有控件，自动给交互信号绑定日志回调，也不需要修改原有业务的信号槽逻辑。

实现步骤 #

1. 实现递归绑定函数，针对不同控件类型给对应交互信号绑定日志回调。
2. 主窗口初始化完成后调用一次递归绑定，处理所有已创建的控件。
3. 新增全局事件过滤器监听QEvent::ChildAdded事件，给后续动态创建的控件自动绑定日志回调。

示例代码 #

// 全局日志写入方法
void writeGlobalLog(const QString& content) {
    static QFile logFile("user_interaction.log");
    if (!logFile.isOpen()) logFile.open(QIODevice::Append | QIODevice::Text);
    QTextStream out(&logFile);
    out << QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss.zzz ") << content << "\n";
    out.flush();
}

// 递归绑定控件交互信号
void bindLogForWidget(QObject *obj) {
    if (!obj) return;
    // 绑定按钮点击信号
    if (auto *btn = qobject_cast<QAbstractButton*>(obj)) {
        QObject::connect(btn, &QAbstractButton::clicked, [btn](){
            writeGlobalLog(QString("按钮点击 | 控件名：%1 | 显示文本：%2").arg(btn->objectName(), btn->text()));
        });
    }
    // 绑定输入框文本变更信号
    else if (auto *edit = qobject_cast<QLineEdit*>(obj)) {
        QObject::connect(edit, &QLineEdit::textChanged, [edit](const QString& text){
            writeGlobalLog(QString("输入框编辑 | 控件名：%1 | 当前内容：%2").arg(edit->objectName(), text));
        });
    }
    // 可扩展下拉框、复选框、滑动条等其他控件的信号绑定
    // 递归处理子控件
    for (auto *child : obj->children()) {
        bindLogForWidget(child);
    }
}

// 处理动态创建控件的事件过滤器
class DynamicWidgetLogger : public QObject
{
protected:
    bool eventFilter(QObject *watched, QEvent *event) override {
        if (event->type() == QEvent::ChildAdded) {
            auto *childEvent = static_cast<QChildEvent*>(event);
            bindLogForWidget(childEvent->child());
        }
        return QObject::eventFilter(watched, event);
    }
};

接入逻辑：

// 在主窗口初始化完成后调用一次，处理所有静态创建的控件
bindLogForWidget(&mainWindow);
// 安装过滤器处理动态创建的控件
qApp->installEventFilter(new DynamicWidgetLogger);

两种方案均可根据实际需求扩展支持的交互类型，不需要修改原有业务代码，改造成本极低。

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