QT程序报错解决方案：Cannot queue arguments of type ‘QTextCharFormat‘ 或 ‘QTextCursor‘

项目场景：

项目场景：基于QT实现的C++某程序，搭载在Linux环境中。

---

问题描述

执行程序时，发现log中报错如下内容：

QObject::connect: Cannot queue arguments of type 'QTextCharFormat'
(Make sure 'QTextCharFormat' is registered using qRegisterMetaType().)
QObject::connect: Cannot queue arguments of type 'QTextCursor'
(Make sure 'QTextCursor' is registered using qRegisterMetaType().)

---

解读报错：

错误信息 QObject::connect: Cannot queue arguments of type ‘QTextCharFormat’ 和 QObject::connect: Cannot queue arguments of type ‘QTextCursor’ 表示你正在尝试在 不同线程之间 使用 QTextCharFormat 和 QTextCursor 类型作为信号和槽的参数传递，但由于这些类型没有注册为 Qt 的元对象系统中的元类型，Qt 无法在线程之间对它们进行序列化和传递。

---

原因分析：

Qt 的信号槽机制在不同线程之间传递数据时，会将数据打包为事件并通过事件队列发送，这就要求所有传递的数据类型都必须是 可序列化的。为了让 Qt 能够在线程之间传递数据类型，必须使用 qRegisterMetaType() 函数将这些类型注册到 Qt 的元对象系统中。

在代码中，QTextCharFormat 和 QTextCursor 这两种类型没有默认注册为元类型，Qt 无法自动将它们序列化并在线程之间传递。因此，如果有尝试通过 Qt::QueuedConnection（或不同线程默认情况下使用的连接类型）来传递这些类型时，就会触发这个错误。

---

解决方案：

需要使用 qRegisterMetaType 函数将 QTextCharFormat 和 QTextCursor 注册为元类型，确保它们能够在不同线程之间通过信号槽传递。

main函数，或者主函数内添加如下内容：

// 报错兼容处理(注册 QTextCharFormat 和 QTextCursor)
qRegisterMetaType<QTextCharFormat>("QTextCharFormat");
qRegisterMetaType<QTextCursor>("QTextCursor");