QSettings读取自定义结构体值始终返回{0,0}默认值问题

问题根因 #

你仅通过Q_DECLARE_METATYPE完成了自定义类型的基础声明，但没有向Qt元类型系统注册该类型的数据流序列化/反序列化操作符，导致QSettings读取到配置文件中的二进制内容后，无法将反序列化得到的结构体值正确绑定到返回的QVariant对象上，最终调用.value<T>()时只能拿到值初始化的默认零值{0,0}。

你观察到的调试现象完全匹配该问题的典型表现：

• operator>>内断点能读到正确值，是因为QSettings内部解析ini存储的二进制块时，确实调用了你重载的流操作符，将数据读到了临时构造的结构体对象中
• 外层拿到的是{0,0}，是因为未注册流操作符的前提下，QVariant没有合法路径将临时对象的内容拷贝转换为你要获取的目标类型实例，只能返回默认构造的零值对象

修复步骤 #

1. 在应用初始化阶段（优先放在main函数中，QApplication实例构造完成后、所有QSettings读写操作执行前），添加流操作符注册代码：
   • Qt5版本写法（类型名字符串必须和Q_DECLARE_METATYPE传入的类型完全一致）：

   qRegisterMetaTypeStreamOperators<CharTableView::CellSize>("CharTableView::CellSize");
   

   • Qt6版本写法（无需手动传入类型名，元类型系统可自动识别）：

   qRegisterMetaTypeStreamOperators<CharTableView::CellSize>();
   

2. 无需修改你现有的结构体定义、流操作符重载、写入/读取逻辑，原有代码即可正常工作。

原理补充 #

• Q_DECLARE_METATYPE的作用仅为让Qt元类型系统识别该自定义类型的存在，掌握其内存大小、默认构造、拷贝构造规则，满足存入QVariant的基础要求
• QSettings在ini格式下存储自定义非基础类型时，本质是通过QDataStream将对象序列化为QByteArray后存入配置文件；读取时反向反序列化，这个过程需要元类型系统明确知道对应类型的流操作符实现，必须通过qRegisterMetaTypeStreamOperators显式注册才能完成QVariant到目标类型的正确转换
• 注册代码必须早于所有涉及该类型的QSettings读写操作，若在业务窗口构造阶段才执行注册，早于注册时机触发的读取逻辑依然会返回默认值。

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