Qt项目通常会由QML来负责界面的展示和交互，而设备通信、文件处理、算法和业务逻辑，则交给C++去承担，这两边并不是直接去调用普通的C++函数，而是通过Qt的元对象系统，把属性、方法和信号传递过去，只要类的声明、对象的注册，还有数据类型的处理都正确，QML就能读取到C++的状态，去调用业务方法，也可以接收C++主动发出的结果通知。

　　一、Qt QML和C++怎么交互

　　Qt提供了类型注册、对象注入、属性绑定和信号槽等多种方式，项目规模较小时，可以直接把对象暴露出去，模块一多，注册正式的QML类型或者单例，就会更加合适。

　　1、向QML暴露C++方法

　　先检查【C++类声明】，确认类继承自QObject，并正确加入Q_OBJECT宏。

　　那些需要被QML调用的方法，可以声明成公共的槽函数，或者在公共方法的前面加上Q_INVOKABLE，普通的public函数虽然能被C++代码调用，却不会自己出现在QML环境里面，按照Qt官方的说明，QObject派生类的公共槽函数，还有带了Q_INVOKABLE的方法，是可以由QML去调用的。

　　2、注册类型或提供对象实例

　　当需要由QML来创建对象的时候，就可以使用QML_ELEMENT或者qmlRegisterType去注册类型，如果只是要提供一个全局的服务对象，那注册一个单例就可以了，小项目也能通过setContextProperty把已有的对象放进QML上下文，可这样一来，就会形成一些不容易察觉的上下文依赖，组件的复用和静态检查都会受到影响，大一点的项目，用正式的类型、单例或者根对象的属性，会更稳妥一些。

　　3、用属性和信号同步状态

　　那些持续变化的数据，应当通过Q_PROPERTY向QML暴露，并且给它配上对应的NOTIFY信号，C++里的值发生变化以后，把通知发出去，QML的绑定才会重新去计算，一次性动作适合去调用方法，而异步的结果和状态变化，则更适合使用信号，不要让QML反反复复地去调用C++函数来轮询数据。

　　二、Qt QML调用C++方法失败怎么排查

　　调用失败的时候，应用程序有时候并不会直接崩溃掉，而是在运行的输出里面提示对象没有定义、方法不存在，或者是参数没办法转换，排查的时候，应该先看错误的位置，再去检查类的声明、注册的先后顺序，还有调用时给的参数。

　　1、检查方法是否进入元对象系统

　　在【应用程序输出】中查看是否出现“不是函数”“属性未定义”或类型注册失败等提示。

　　要是类里面少了Q_OBJECT，方法又没有声明成Q_INVOKABLE或者公共的槽函数，QML这边就识别不到，改完宏、属性或者槽函数之后，还要重新去执行构建系统的配置，并且完整地编译一次，避免旧的元对象代码还在被继续使用。

　　2、检查对象是否在加载QML前注册

　　qmlRegisterType、单例注册，或者setContextProperty这些，都应该在QML组件加载之前弄好，如果先让引擎把主界面加载进来，再回过头去注入C++对象，那界面创建的时候就找不到对应的那个名字了，使用注册类型的时候，还要核对QML里的import模块名、版本，跟C++注册时填写的URI是不是完全一致。

　　3、检查参数和返回值类型

　　QML跟C++之间交换的数据，必须是QML引擎能够识别和转换的类型，QString、QVariant、常见的容器，还有QObject的指针，一般可以直接处理，自定义的结构体、枚举或者容器，可能就需要去注册一下，参数的数量、顺序或者类型对不上号的时候，QML也许找到了同名的方法，却没办法完成调用。

　　三、Qt QML和C++交互怎样保持稳定

　　要让交互的接口稳定下来，关键就是让界面层只去依赖明确的业务接口，不去直接碰一大堆底层对象，属性用来展示状态，方法用来提交操作，信号用来返回异步的结果，这样的一种分工，比起把所有功能都塞进一个全局对象里面，要好维护得多。

　　1、避免暴露过多内部对象

　　C++的接口应该围着页面真正需要的数据去设计，不要把数据库、通信对象和线程对象全部直接交给QML，可以在中间加上一层控制器或者视图模型，让它来负责转换数据，并且把可以调用的范围给限制住。

　　2、注意对象生命周期

　　通过指针暴露给QML的QObject，必须在界面使用它的这段时间里，一直保持有效，对象已经被销毁，可是QML那边还留着对它的引用，后面再去调用就会失效，返回QObject指针的时候，还要明确这个对象是由C++来管，还是由QML来管，免得重复释放或者提前销毁。

　　3、让耗时任务异步返回

　　文件扫描、网络请求，还有复杂的计算，这些都不应该长时间占用界面线程，QML调用C++以后，可以马上返回，再由C++通过信号去发送进度和结果，这样做，一来能让界面还保持着响应，二来也能把错误状态集中交给QML去显示。

　　总结

　　Qt QML和C++之间的交互，主要是靠QObject的元对象系统、Q_INVOKABLE、槽函数、Q_PROPERTY和信号在支撑，Qt QML调用C++方法失败了，就应该依次去检查类的声明、对象注册的时机、模块的导入、对象的生命周期，还有参数的类型，在项目里再把状态、操作和异步结果分开来设计，能够减少对象未定义、属性不更新，还有调用偶尔会失效这些问题。