Qt中使用QDataStream序列化自定义QMetaType失败问题求助

你遇到的问题核心是：Q_DECLARE_METATYPE只是让QVariant能够存储你的Basic类型，但并没有告诉QDataStream如何序列化/反序列化这个类型。Qt的QVariant在通过QDataStream读写时，要求对应的自定义类型必须实现流操作符（operator<<和operator>>），并且注册这些操作符，否则就会出现你看到的unable to save/load type错误。

具体解决步骤 #

1. 在Basic类的头文件中声明流操作符

因为流操作符需要访问Basic的成员变量，我们需要把它们声明为友元函数：

// basic.h
#include <QMetaType>
#include <QDataStream>

struct Basic {
    Basic();
    Basic(const Basic &basic);
    ~Basic();
    int value;

    // 声明流操作符为友元
    friend QDataStream &operator<<(QDataStream &out, const Basic &basic);
    friend QDataStream &operator>>(QDataStream &in, Basic &basic);
};

Q_DECLARE_METATYPE(Basic)

2. 实现流操作符

在basic.cpp中添加这两个操作符的实现，定义如何把Basic对象写入流和从流中读取：

// basic.cpp
#include "basic.h"

Basic::Basic() {}
Basic::Basic(const Basic &basic) { value = basic.value; }
Basic::~Basic(){}

// 实现写入流操作
QDataStream &operator<<(QDataStream &out, const Basic &basic) {
    out << basic.value;
    return out;
}

// 实现读取流操作
QDataStream &operator>>(QDataStream &in, Basic &basic) {
    in >> basic.value;
    return in;
}

3. 注册流操作符

在你的main函数开头，QApplication初始化之后，注册Basic类型的流操作符：

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);
    
    // 注册Basic类型的流操作符
    qRegisterMetaTypeStreamOperators<Basic>("Basic");

    // 你的原有代码...
    QString test1("/test1/");
    const QString path1(QDir::homePath()+test1);
    // ... 其余代码保持不变
}

另外，注意你原有代码里的一个小错误：读取魔术数时用了dataStream1而不是dataStream2，这会导致读取位置错误，需要修正：

// 原错误代码
// dataStream1 >> magic;
// 修正为
dataStream2 >> magic;

为什么原来的代码不行？ #

• Q_DECLARE_METATYPE的作用是让QVariant能够存储和转换Basic类型，但它并没有处理序列化逻辑。
• QDataStream处理QVariant中的自定义类型时，依赖于该类型的流操作符，以及通过qRegisterMetaTypeStreamOperators注册的元类型信息，这样Qt才能知道如何将该类型的数据写入/读取流。

完成以上修改后，你的代码应该就能正确保存和加载Basic类型的QVariant了，最终输出会是14 = 14 = 14。

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