QObject派生类中嵌套QObject子类的链接错误原因及解决方法

在继承自QObject的类A中定义嵌套类B（B也继承QObject），希望隐藏B的实现，代码如下：

// a.h
class A : public QObject
{
    Q_OBJECT
public:
    explicit A(QObject* parent=nullptr);
private:
    class B;
    QSharedPointer<B> m_impl;
};

//a.cpp
class A::B : public QObject
{
    Q_OBJECT
public:
    // 成员实现
};

A::A(QObject* parent) : 
    QObject(parent),
    m_impl(QSharedPointer<B>(new B()))
{
}

编译链接时出现错误：

undefined reference to 'vtable for A::B'
undefined reference to 'A::B::staticMetaObject'

Qt的元对象编译器（MOC）仅会扫描头文件中的Q_OBJECT宏，负责生成元对象相关的代码（包括虚函数表vtable、staticMetaObject等）。但此处A::B的定义和Q_OBJECT宏放在了.cpp文件中，MOC无法识别并处理该宏，导致链接时缺少对应的符号。

方案1：使用私有头文件存放B的定义 #

创建仅内部使用的私有头文件（如a_p.h），将A::B的定义移至该文件，确保MOC能扫描到其中的Q_OBJECT宏：

// a_p.h（私有头文件，不对外暴露）
#ifndef A_P_H
#define A_P_H

#include <QObject>
#include "a.h"

class A::B : public QObject
{
    Q_OBJECT
public:
    // B的成员定义与实现
};

#endif

修改a.cpp，包含私有头文件：

#include "a.h"
#include "a_p.h"

A::A(QObject* parent) : 
    QObject(parent),
    m_impl(QSharedPointer<B>(new B()))
{
}

方案2：移除B的Q_OBJECT宏（若无需元对象功能） #

如果A::B不需要Qt元对象系统的功能（如信号槽、属性、反射等），可直接删除B类中的Q_OBJECT宏，此时无需依赖MOC生成额外代码，链接错误会消失。

方案3：使用Qt官方PIMPL宏（可选） #

借助Qt提供的Q_DECLARE_PRIVATE、Q_D等宏实现PIMPL模式，本质与方案1一致，但更贴合Qt的惯用写法，同样需要将私有实现放在私有头文件中。

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