QVariant 的核心用途

---

QVariant 是 Qt 中用于统一封装多种数据类型的通用容器类，能够在不同模块间传递未知或动态类型的数据。其核心使用场景如下：

场景	描述
Qt 属性系统	存储 QObject 的动态属性，支持任意类型。
模型/视图框架	在 QAbstractItemModel 中通过不同角色（如显示文本、图标）返回多种类型数据。
跨信号槽传递多类型参数	通过 QVariant 封装不同类型参数，统一信号与槽的接口。
配置存储与序列化	保存应用配置（如 QSettings）或序列化数据（如 JSON、XML），处理多类型字段。
数据库操作	处理数据库查询结果中的异构字段类型（如整数、字符串、日期）。
自定义类型处理	通过注册自定义类型，允许 QVariant 存储用户定义的结构体或类实例。

---

具体用例及代码

1. 动态属性存储（Qt属性系统）

#include <QObject>
#include <QVariant>
#include <QDebug>

class UserData : public QObject {
    Q_OBJECT
public:
    // 设置动态属性
    void setProperty(const QString &name, const QVariant &value) {
        QObject::setProperty(name.toUtf8(), value);
    }

    // 获取动态属性
    QVariant getProperty(const QString &name) {
        return QObject::property(name.toUtf8());
    }
};

int main() {
    UserData obj;
    obj.setProperty("age", 25);                 // 整数
    obj.setProperty("name", "Alice");           // 字符串
    obj.setProperty("isActive", true);           // 布尔值

    qDebug() << obj.getProperty("age").toInt();     // 输出: 25
    qDebug() << obj.getProperty("name").toString(); // 输出: "Alice"
    return 0;
}

说明：通过 QVariant 统一管理对象的动态属性，支持多种数据类型。

---

2. 模型/视图框架（返回多类型数据）

// 自定义模型的数据方法
QVariant MyModel::data(const QModelIndex &index, int role) const {
    if (role == Qt::DisplayRole) {
        return QString("Row %1").arg(index.row());  // 返回字符串
    } else if (role == Qt::UserRole) {
        return QColor(Qt::blue);                   // 返回颜色
    }
    return QVariant(); // 无效数据
}

// 在视图中获取数据
QModelIndex index = model->index(0, 0);
QString text = model->data(index, Qt::DisplayRole).toString();
QColor color = model->data(index, Qt::UserRole).value<QColor>();

说明：同一模型索引（Index）通过不同角色返回字符串、颜色等不同类型数据。

---

3. 信号槽传递多类型参数

// 信号声明
signals:
    void dataUpdated(const QVariant &value);

// 槽函数
void onDataUpdated(const QVariant &value) {
    if (value.canConvert<int>()) {
        int num = value.toInt();
    } else if (value.canConvert<QString>()) {
        QString str = value.toString();
    }
}

// 发射信号时封装数据
emit dataUpdated(QVariant(42));       // 传递整数
emit dataUpdated(QVariant("Hello"));  // 传递字符串

说明：通过 QVariant 统一参数类型，接收方根据实际类型解析数据。

---

4. 自定义类型存储（需注册元类型）

// 自定义结构体
struct Person {
    QString name;
    int age;
};
Q_DECLARE_METATYPE(Person) // 声明元类型

// 注册自定义类型（通常在 main 函数中）
qRegisterMetaType<Person>("Person");

// 存储到 QVariant
Person p {"Bob", 30};
QVariant var = QVariant::fromValue(p);

// 从 QVariant 提取数据
if (var.canConvert<Person>()) {
    Person p2 = var.value<Person>();
    qDebug() << p2.name; // 输出: "Bob"
}

说明：通过元类型系统支持用户自定义类型的存储和转换。

---

5. 配置文件存储（QSettings）

QSettings settings("MyApp", "Settings");
settings.setValue("BackgroundColor", QColor(Qt::white)); // 存储颜色
settings.setValue("WindowSize", QSize(800, 600));        // 存储尺寸

// 读取配置
QColor color = settings.value("BackgroundColor").value<QColor>();
QSize size = settings.value("WindowSize").toSize();

说明：QSettings 使用 QVariant 存储配置项，支持多种数据类型。

---

注意事项

1. 类型安全：
   • 使用 canConvert<T>() 检查类型是否可转换。
   • 使用 type() 或 typeName() 获取实际类型。
2. 自定义类型注册：
   • 必须使用 Q_DECLARE_METATYPE(Type) 和 qRegisterMetaType<Type>()。
3. 性能：
   • 频繁的类型转换可能影响性能，建议在关键路径避免过度使用。
4. 空值处理：
   • 使用 isNull() 或 isValid() 检查 QVariant 是否包含有效数据。

---

总结

场景	推荐度	替代方案
动态属性	⭐⭐⭐⭐⭐	无（Qt属性系统依赖）
模型/视图数据	⭐⭐⭐⭐⭐	模板类（如 QStandardItem）
信号槽多类型参数	⭐⭐⭐⭐	多态或模板信号槽（Qt 5.15+）
配置存储	⭐⭐⭐⭐	JSON/XML（需手动解析）
数据库操作	⭐⭐⭐⭐	特定类型的 ORM 框架

QVariant 是 Qt 中处理异构数据的瑞士军刀，在灵活性要求高的场景下表现卓越，但需注意类型安全和性能取舍。