QML与C++互调需满足严格前提：C++函数须用Q_INVOKABLE或public slots暴露，QML函数须为命名函数且组件就绪；参数类型受限，调用路径取决于注册方式，返回值需显式捕获。
Qt 中 QML 与 C++ 互相调用函数不是“配好就能用”，而是有明确的边界和前提：C++ 函数必须显式暴露给元对象系统，QML 函数必须是命名函数且组件已就绪。不满足任一条件，调用会静默失败或崩溃。
QML 调用 C++ 函数：必须加 Q_INVOKABLE 或用 public slots
QML 无法直接访问普通 public 成员函数。只有被 Qt 元对象系统识别的方法才能被调用：
-
Q_INVOKABLE是最推荐的方式，语义清晰、支持返回值和参数（基本类型、QVariant、QList、QJsonObject等） -
public slots也能被调用，但槽函数本质是为信号连接设计的，语义不如Q_INVOKABLE直观 - 函数参数不能是裸指针、自定义未注册类型、或 C++ STL 容器（如
std::vector），否则编译或运行时报错 - 注册方式决定调用路径：用
setContextProperty()注入后，QML 中直接通过属性名调用；用qmlRegisterType()注册后，需在 QML 中import模块并实例化
示例（C++ 类中）：
class Backend : public QObject {
Q_OBJECT
public:
explicit Backend(QObject *parent = nullptr) : QObject(parent) {}
Q_INVOKABLE QString fetchData(const QString &key) { return "data:" + key; }
Q_INVOKABLE QVariantMap getStats() { return {{"count", 42}, {"ok", true}}; }
};
main.cpp 中注入：
立即学习“C++免费学习笔记（深入）”；
Backend backend;
engine.rootContext()->setContextProperty("backend", &backend);
QML 中即可：backend.fetchData("user") 或 backend.getStats().count。
C++ 调用 QML 函数：必须用 QMetaObject::invokeMethod()，且函数不能是箭头函数
QML 中定义的函数，C++ 只能通过反射机制调用，核心是 QMetaObject::invokeMethod()。但它有硬性限制：
- 目标函数必须是具名函数（
function myFunc() { ... }），不能是内联匿名函数或箭头函数（onClicked: () => {...}） - QML 组件必须已加载完成（
status === Loader.Ready或Component.onCompleted已触发），否则rootObject()或findChild()返回空指针 - 参数类型要严格匹配：传
QVariantList对应 QML 的Array，传QVariantMap对应Object；传QString没问题，但传char*会崩 - 返回值需用
Q_RETURN_ARG捕获，否则拿不到结果（即使函数有return）
示例（QML 中）：
Item {
function processData(input) {
console.log("C++ sent:", input)
return { result: "ok", timestamp: Date.now() }
}
}
C++ 中调用：
QObject *root = engine.rootObjects().first();
if (root) {
QVariant returnedValue;
QMetaObject::invokeMethod(root, "processData",
Q_RETURN_ARG(QVariant, returnedValue),
Q_ARG(QVariant, "hello from C++"));
qDebug() << "QML returned:" << returnedValue; // 输出 QVariantMap
}
传复杂数据：QML 和 C++ 之间靠 QVariantMap / QVariantList 互通
QML 的 Object 和 Array 在 C++ 侧天然映射为 QVariantMap 和 QVariantList，这是最稳妥的结构化数据通道：
- QML 传对象给 C++：
myCppObj.handle({ name: "Alice", age: 30 })→ C++ 接收为QVariantMap - C++ 传列表给 QML：
QVariantList list = {"a", "b", 123}; invokeMethod(..., Q_ARG(QVariant, list));→ QML 中是标准Array - 避免手动序列化 JSON 字符串：虽然可行，但多一层解析开销，且易出错；原生
QVariant转换更高效、类型安全 - 注意嵌套深度：QML 支持任意嵌套，但 C++ 侧若用
QVariantMap接收，遍历时需递归判断value.type() == QVariant::Map或List
容易被忽略的关键点：生命周期和线程安全
很多崩溃不是语法错，而是对象早于调用被销毁，或跨线程访问：
- 用
setContextProperty()注入的 C++ 对象，其生命周期必须长于 QML 引擎（通常设为全局或new后不delete）；否则 QML 调用时访问野指针 -
rootObject()返回的对象是引擎管理的，只要QQmlApplicationEngine活着它就活着；但用QQmlComponent::create()创建的临时对象，需自行delete - QML 函数只能在创建它的线程（通常是 GUI 线程）中被
invokeMethod()调用；从工作线程直接调用会 crash，必须用QMetaObject::invokeMethod(..., Qt::QueuedConnection)投递到主线程 - QML 中的
function本身没有所有权概念，它依附于所在 QML 对象；一旦该对象被销毁（如Loader.source切换），函数就不可再调
