Qt5/C++中虚信号触发clazy-virtual-signal警告的原因咨询

为什么虚信号会触发警告？ #

Qt的信号机制依赖moc（Meta-Object Compiler）自动生成发射逻辑，信号本身不需要也不应该被声明为虚函数：

• 信号不是手动实现的成员函数，moc会为每个信号生成对应的emit逻辑代码。如果把信号声明为virtual，moc生成的代码会被当作虚函数的实现，这完全违背了Qt信号的设计初衷。
• 子类重写虚信号后，moc的处理逻辑会混乱：基类指针调用信号时，实际执行的是子类moc生成的代码，这可能导致信号槽连接行为异常，比如参数不匹配、信号无法正确触发槽函数等。
• clazy作为Qt专属的静态分析工具，会主动识别这种违背Qt规范的写法，抛出警告来避免后续潜在的bug。

正确的替代方案 #

如果需要让子类自定义信号的触发逻辑，不要直接把信号设为虚函数，而是用“虚成员函数+信号”的组合：

1. 基类定义普通信号，同时声明一个虚的发射函数
2. 子类重写这个发射函数，在函数内实现自定义逻辑后发射信号

示例代码：

// 基类
class BaseWidget : public QWidget
{
    Q_OBJECT
public:
    // 虚函数，子类可重写以自定义触发逻辑
    virtual void triggerCustomSignal()
    {
        emit customSignal("default content");
    }

signals:
    // 普通信号，无需virtual
    void customSignal(const QString& msg);
};

// 子类
class DerivedWidget : public BaseWidget
{
    Q_OBJECT
public:
    void triggerCustomSignal() override
    {
        // 子类自定义逻辑
        QString customMsg = "derived content";
        // 发射基类信号
        emit customSignal(customMsg);
    }
};

这样既满足了子类自定义行为的需求，又完全符合Qt信号槽的设计规范，从根源上消除了clazy的警告。

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