QT-自定义信号与槽（指南）

1. 信号与槽的基本概念

1.1 信号的特点

• 声明位置：必须写在类的signals:区域，无需访问修饰符（默认public）
• 参数传递：支持任意类型参数传递，参数列表需与对应槽函数匹配
• 实现规则：只需声明无需实现，由Qt元对象编译器(moc)自动生成代码
• 发射方式：使用emit关键字触发信号，实际是空宏（emit mySignal()等效mySignal()）

1.2 槽函数的特点

• 声明位置：
  • Qt4：必须声明在public/protected/private slots:区域
  • Qt5：可声明为普通成员函数（建议保留slots标识语义）
• 实现要求：必须完整实现函数体，支持参数重载
• 参数规则：参数数量可≤信号参数，顺序需一致（如信号void sig(int, QString)可接槽void slot(int)）

2. 自定义信号与槽的完整实现流程

2.1 定义信号

class Sender : public QObject {
    Q_OBJECT
signals:
    void dataUpdated(int value);       // 基本信号
    void complexSignal(QString msg, QDateTime time);  // 带多参数信号
    void overloadedSignal();           // 信号重载
    void overloadedSignal(int count);  // 重载版本
};

2.2 定义槽函数

class Receiver : public QObject {
    Q_OBJECT
public slots:
    void handleUpdate(int val) {       // 完整接收参数
        qDebug() << "Received value:" << val; 
    }

    void simpleHandle() {              // 忽略参数
        qDebug() << "Signal received!";
    }
};

2.3信号与槽的连接

关键步骤​​：
使用 QObject::connect() 建立信号与槽的关联，支持以下两种语法（推荐使用Qt5的语法）：

// Qt5语法（编译期类型检查）
connect(sender, &Sender::dataUpdated, receiver, &Receiver::handleUpdate);

// Qt4旧语法（运行时动态绑定，已不推荐）
connect(sender, SIGNAL(dataUpdated(int)), receiver, SLOT(handleUpdate(int)));

2.4触发信号

通过 emit 关键字发射信号

void Sender::triggerSignal() {
    emit dataUpdated(100);  // 发射基本信号
    emit complexSignal("Warning", QDateTime::currentDateTime()); 
    emit overloadedSignal(5);  // 发射重载信号
}

3. 信号槽连接的高级技巧

3.1 重载处理

// 使用函数指针明确指定重载版本
void (Sender::*overloadVoid)() = &Sender::overloadedSignal;
void (Sender::*overloadInt)(int) = &Sender::overloadedSignal;

connect(sender, overloadVoid, receiver, &Receiver::simpleHandle);
connect(sender, overloadInt, receiver, &Receiver::handleUpdate);

3.2 连接方式选择

连接类型选择​​：
通过connect函数的第5个参数指定执行方式

connect(sender, &Sender::dataUpdated, receiver, &Receiver::handleUpdate, Qt::QueuedConnection);

连接类型	适用场景
Qt::DirectConnection	单线程实时响应（如GUI线程内操作）
Qt::QueuedConnection	跨线程安全通信（如后台线程更新UI）
Qt::BlockingQueuedConnection	需要同步执行的操作（慎用，可能引发死锁）

3.3 Lambda表达式作为槽

connect(sender, &Sender::dataUpdated, [=](int val){
    qDebug() << "Lambda处理数值:" << val * 2;
});

4. 参数传递规则

• 类型兼容：信号参数必须可隐式转换为槽参数类型（如int→double）
• 引用传递：跨线程时建议使用const引用避免拷贝（const QString&）
• 默认参数：槽函数不支持默认参数（如void slot(int x=0)会编译报错）

5. 线程安全实践

5.1 跨线程通信

// 工作线程类
class Worker : public QObject {
    Q_OBJECT
signals:
    void resultReady(const QImage &img);

public slots:
    void startProcessing() {
        // 耗时操作...
        emit resultReady(processedImage);
    }
};

// 主线程连接
Worker *worker = new Worker;
QThread *thread = new QThread;
worker->moveToThread(thread);  // 关键步骤
connect(thread, &QThread::started, worker, &Worker::startProcessing);
connect(worker, &Worker::resultReady, this, &MainWindow::updateUI, Qt::QueuedConnection);
thread->start();

5.2 断开连接

通过 disconnect() 管理连接关系，防止内存泄漏

// 断开特定连接
disconnect(sender, &Sender::dataUpdated, receiver, &Receiver::handleUpdate);

// 断开所有关联
disconnect(sender, nullptr, receiver, nullptr);

6. 常见问题排查

1. 信号未触发：

   • 检查类是否包含Q_OBJECT宏
   • 确认信号槽参数严格匹配（使用qOverload处理重载）
   • 验证对象生命周期（避免悬空指针）

2. 跨线程崩溃：

   • 确保使用moveToThread转移对象线程归属
   • 优先使用Qt::QueuedConnection连接方式

3. 性能优化：

   • 减少高频信号的参数拷贝（使用共享指针或const引用）
   • 合并多个信号为复合信号（如statusChanged(int code, QString msg)）

7. 最佳实践建议

1. 信号设计原则：

   • 用名词命名信号（如dataReceived）
   • 参数应包含完整上下文信息（如downloadProgress(qint64 bytes, qint64 total)）

2. 槽函数规范：

   • 保持槽函数简短（复杂逻辑移至独立方法）
   • 避免在槽函数中执行耗时操作

3. 连接管理：

   • 使用Qt::UniqueConnection防止重复连接
   • 利用RAII模式管理连接生命周期

QMetaObject::Connection conn = connect(...);
QObject::connect(receiver, &QObject::destroyed, [conn]{ disconnect(conn); });

通过合理使用Qt信号槽机制，可以构建出高内聚、低耦合的应用程序架构。建议结合Qt Creator的调试工具和QObject::dumpObjectTree()方法进行运行时对象关系分析。