QObject派生类的全部实现要求有哪些？附模板代码求核查

核心问题：拷贝构造函数的适用场景 #

QObject 派生类严禁声明/使用默认拷贝构造、拷贝赋值运算符。
Qt 从设计上就禁止QObject实例拷贝：QObject的父子对象树所有权、信号槽连接、唯一对象标识、动态属性、事件过滤器绑定等运行时状态全部和实例内存地址强绑定，拷贝生成的新对象无法合法复刻这些状态，强行实现拷贝逻辑只会制造悬空指针、信号槽断连、对象树内存泄漏等极难排查的问题。
你之前看到的“需要公有默认构造、公有拷贝构造、公有析构”的要求，仅适用于非QObject派生的、要注册到元对象系统的值类型，和QObject子类的规则完全不冲突，属于两类自定义类型的注册要求混淆。

你整理的实现要求勘误 #

• 公有默认构造：QObject子类确实需要，但注意不要重复定义默认构造。你模板中ClassName(QObject *parent = nullptr);本身就是带默认参数的合法默认构造，后面额外写ClassName() = default;会触发重复定义编译错误，保留前者即可。
• 公有拷贝构造：QObject子类不需要，反而应该主动禁用，在类的public区域显式标记拷贝构造和拷贝赋值为delete才是正确做法。
• 公有析构函数：QObject作为多态基类本身带虚析构，子类的析构函数必须加virtual修饰，否则通过基类指针释放子类实例时会触发未定义行为，你模板中的析构函数声明缺少virtual关键字。
• Q_OBJECT宏：要求正确。所有需要使用信号槽、动态属性、qobject_cast能力的QObject子类，必须在类声明的最开头（访问修饰符之前，因为宏展开的成员默认是私有权限）添加该宏，添加后需要重新执行qmake/moc流程才能正常编译。
• Q_PROPERTY宏：不是强制要求。仅当你需要让类成员被元对象系统识别（比如QML访问、QMetaProperty动态读写、属性动画绑定）时才需要声明，类内部使用的普通成员无需强行加该宏。另外注意属性绑定的NOTIFY信号仅在属性值真正发生变化时才触发，不要每次调用setter都发射信号，避免冗余的UI刷新开销。
• Q_DECLARE_METATYPE(T)：QObject子类不需要添加该宏。QObject子类的指针类型已经被元对象系统自动识别，可以直接存入QVariant、跨线程信号传递。该宏仅用于值类型注册，你模板中此处的类型名还写了和类名不匹配的TypeName，属于笔误。
• Q_ENUM宏：你的写法存在位置错误。全局作用域定义的枚举无法直接用Q_ENUM注册——Q_ENUM只能在类内部注册类成员枚举，全局枚举需要配合Q_NAMESPACE宏用Q_ENUM_NS注册，更通用的做法是直接把枚举定义到类内部，再在类内调用Q_ENUM注册。

模板头文件其他问题与规范建议 #

• 所有成员变量必须在声明时或构造函数中赋初始值，你模板中的T* m_memberA是野指针，int m_memberB、E m_memberC也未初始化，会触发未定义行为，建议直接在成员声明处给默认值。
• 指针类型的成员如果持有QObject派生类实例，要明确所有权：如果是当前类持有的子对象，要在赋值时设置parent加入对象树自动回收；如果是弱引用，要连接被引用对象的destroyed信号及时置空指针，避免悬空引用。
• 枚举建议使用C++强类型枚举enum class替代传统C风格枚举，避免命名空间污染，Qt 5.8及以上版本完全支持Q_ENUM注册强类型枚举。
• 头文件尽量使用前置声明减少include依赖，模板中如果T是指针类型，不需要直接#include <T.h>，在头文件前置声明class T;，在源文件再包含T的头文件即可，可以大幅提升编译速度。
• 构造函数建议加explicit修饰，避免隐式转换带来的非预期行为。

修正后的参考模板 #

#ifndef CLASSNAME_H
#define CLASSNAME_H

#include <QObject>

// 前置声明减少头文件编译依赖
class T;

class ClassName : public QObject
{
    Q_OBJECT
    // 枚举定义在类内部
    enum class E{
        E0,
        E1,
        E2
    };
    Q_ENUM(E)

    Q_PROPERTY(T* memberA READ memberA WRITE setMemberA NOTIFY memberAChanged)
    Q_PROPERTY(int memberB READ memberB WRITE setMemberB NOTIFY memberBChanged)
    Q_PROPERTY(E memberC READ memberC WRITE setMemberC RESET resetMemberC)

public:
    // 唯一默认构造，带parent参数，加explicit禁止隐式转换
    explicit ClassName(QObject *parent = nullptr);
    // 显式禁用拷贝构造和拷贝赋值
    ClassName(const ClassName&) = delete;
    ClassName& operator=(const ClassName&) = delete;
    // 子类虚析构加override标记
    virtual ~ClassName() override;
    
    // Getter遵循const正确性
    T* memberA() const {return m_memberA;}
    int memberB() const {return m_memberB;}
    E memberC() const {return m_memberC;}

    // Setter声明
    void setMemberA(T* newA);
    void setMemberB(int newB);
    void setMemberC(E newC);

signals:
    void memberAChanged(T*);
    void memberBChanged(int);

public slots:
    void resetMemberC();

private:
    // 成员直接初始化，避免野指针和未定义值
    T* m_memberA = nullptr;
    int m_memberB = 0;
    E m_memberC = E::E0;
};

// QObject子类不需要额外加Q_DECLARE_METATYPE，指针类型由元对象系统自动注册

#endif // CLASSNAME_H

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