Qt6QmlWorkerScript.dll 的核心功能

Qt6QmlWorkerScript.dll 是 Qt 6 框架 QML 运行时中的一个功能模块库，对应 QML 的 WorkerScript 模块。它的核心职责是把 WorkerScript 这一 QML 类型暴露给 QML 引擎，并把 JavaScript 执行体从 GUI 线程迁移到独立工作线程中运行，从而让界面保持流畅。

一、核心功能

• 注册 WorkerScript QML 类型：导出 QQmlWorkerScript、QQuickWorkerScript 等类，使 QML 中可直接声明 WorkerScript { source: "work.js" } 并完成类型注册与版本映射。
• 多线程脚本执行：为每个 WorkerScript 实例创建独立的 QThread 与 QJSEngine，脚本在非 GUI 线程中解释执行，主线程的渲染与事件循环不受阻塞。
• 跨线程消息通道：实现 postMessage() 与 onMessage 信号，依托 Qt 元对象系统与信号槽机制，将数据投递到对端线程，避免共享内存带来的竞态条件。
• 生命周期与上下文管理：负责脚本源的加载、编译、线程启动与销毁，以及与 QQmlEngine、QQmlContext 之间的绑定与解绑。
• 依赖协同：与 Qt6Qml.dll、Qt6Core.dll 协同工作，调用 QJSEngine 完成语法解析与执行。

二、缺少该 DLL 的影响

该文件通常由 windeployqt 在部署阶段复制到可执行文件目录。一旦缺失或版本不匹配，后果具有连锁性：

1. 进程无法启动：Windows 加载器解析导入表时失败，弹出“无法启动此程序，因为计算机中丢失 Qt6QmlWorkerScript.dll”，或静默退出并返回 0xc0000135。
2. QML 模块解析失败：应用虽能启动，但 QML 引擎抛出 module QtQml.WorkerScript is not installed 之类的错误，相关界面无法实例化。
3. 脚本任务静默失效：声明了 WorkerScript 的组件创建失败，耗时计算无法下发到工作线程，界面出现明显卡顿甚至假死。
4. 调试信息误导：错误常表现为 “Cannot assign to non-existent property” 或插件加载失败，排查时容易误判为 QML 语法问题。
5. 关联组件连带受影响：凡内部依赖 WorkerScript 的第三方 QML 模块（图表、数据模型、文件解析等）都会一并报错。

修复方式通常是使用与 Qt 版本一致的 windeployqt 重新部署，或从 Qt 安装目录的 bin 文件夹复制该 DLL 至程序同级目录，并确保 Debug 与 Release 版本匹配。