QML与C++双向通信关键在于注册、暴露与调用三环闭环：setContextProperty适用于全局单例（如Settings），qmlRegisterType支持QML中创建多个实例，QMetaObject::invokeMethod用于C++主动调用QML函数，信号连接实现解耦式双向通知。
QML 和 C++ 能双向通信，关键不是“能不能”，而是“怎么注册、怎么暴露、怎么调用”——漏掉任意一环，Q_INVOKABLE 写了也白写，signal 发了也收不到。
setContextProperty 是最直接的单例暴露方式
适合全局配置、状态管理器、登录用户对象这类「整个应用只该有一个」的 C++ 实例。它把对象挂到 QML 的 root context 上，QML 里直接用变量名访问。
常见错误现象：
- QML 中写
person.name报错 “ReferenceError: person is not defined” —— 检查setContextProperty是否在engine.load()之前调用 - 改了 C++ 端的
name值，QML 界面不刷新 —— 忘加Q_PROPERTY+NOTIFY信号，或信号没 emit
使用场景：你只需要一个 Settings 对象、一个 NetworkManager、一个 AuthController，且不需要在 QML 里 new 多个实例。
立即学习“C++免费学习笔记（深入）”；
参数差异：第三个参数是原始指针（&settings），不能传栈对象或临时对象；生命周期必须长于 QML 引擎，否则访问会 crash。
qmlRegisterType 支持 QML 中 new 多个实例
当你需要在 QML 里动态创建多个同类对象（比如一堆 ControlItem、多个 DataSource），就得用 qmlRegisterType。它注册的是「类型」，不是实例。
容易踩的坑：
- 忘记在类头文件加
Q_OBJECT宏，导致元信息缺失，QML 根本看不到任何属性或方法 - 构造函数带参数，但没实现默认构造函数 —— QML 解析时会失败，报 “Cannot create instance of type XXX”
- 注册语句写在
main()之后，或写在QQmlApplicationEngine构造之前 —— 注册无效
性能影响：注册本身开销极小，但每个 new 出来的实例都走 QObject 构造+元对象初始化，比纯 JS 对象重。别在 Repeater 里高频 new。
QMetaObject::invokeMethod 是 C++ 主动调用 QML 函数的唯一可靠方式
不要试图用 rootObject->findChild<qobject>("xxx")->property("yyy")</qobject> 直接改属性值来触发逻辑 —— 这绕过了 QML 的绑定和信号机制，UI 可能不同步。真要调函数，就用 QMetaObject::invokeMethod。
使用条件：
- 目标对象必须是 QML 组件的根对象，或通过
findChild正确定位到具体 item（如button） - QML 函数必须是
function声明，且不能是箭头函数或 inline 表达式 - 参数类型要严格匹配：
Q_ARG(QVariant, value)是安全兜底，但建议用明确类型如Q_ARG(QString, name)
示例片段：
QObject *button = rootObject->findChild<QObject*>("loginButton");
if (button) {
QMetaObject::invokeMethod(button, "onClicked", Qt::QueuedConnection);
}
注意 Qt::QueuedConnection：避免跨线程调用时崩溃，尤其当 C++ 在工作线程触发 QML 更新时。
信号连接是最解耦、最稳定的双向通知机制
QML 发信号给 C++（如按钮点击、输入完成）、C++ 发信号给 QML（如网络请求完成、数据加载就绪），都应该走 connect。它不依赖对象生命周期顺序，也不要求函数名硬编码。
为什么不用 Q_INVOKABLE 替代？因为信号天然支持一对多、异步、自动断连（parent-child 关系销毁时自动清理）。而 Q_INVOKABLE 是同步调用，一旦 C++ 对象提前析构，QML 再调就 crash。
关键细节：
- C++ 端信号必须在头文件中声明为
signals:，且参数类型需被 Qt 元系统识别（基本类型、QString、QList、自定义类型需Q_DECLARE_METATYPE） - QML 中连接必须用
Connections或直接在组件上写onSignalName，不能用 JS 的addEventListener - 如果信号参数是自定义结构体，记得在
main()里调用qRegisterMetaType<mystruct>()</mystruct>
复杂点往往藏在信号参数的序列化边界上：比如传 QVariantMap 没问题，但传 std::map 就会静默失败；QML 里收到空对象，其实是因为类型没注册。
