H5平台是唯一支持原生Web Worker的uni-app目标平台;App端需用plus.threads,小程序端须用uni.createWorker并遵守workers/目录、路径声明及保活规则。

uni-app 里不能直接照搬浏览器的 new Worker() 写法——H5 可以,App 和小程序平台必须走各自通道,否则运行时直接报 Worker is not defined 或白屏。
哪些平台能用标准 Web Worker?
H5 平台是唯一支持原生 Worker API 的目标。构建时需确保:.worker.js 文件未被 Uglify 或 Terser 删除(尤其在 production 模式下);路径必须是相对静态资源目录的可访问地址(如 static/workers/calc.worker.js)。
- 小程序平台(微信/支付宝等)有自己的
Worker实现,但路径注册、生命周期管理、通信方式均与 Web 不同,uni.createWorker()是入口,且微信限制「同一时间只允许存在一个 Worker」 - App 端(iOS/Android)完全不支持
new Worker(),调用即崩溃——这不是 WebView 能力问题,而是 uni-app 的 App 编译层没打通线程通信链路 - 所有平台都禁止在 Worker 中使用
uni、Vue、require、import(ESM)、document、window等主线程专属对象
小程序端怎么正确创建和复用 Worker?
微信小程序要求 Worker 脚本必须放在 workers/ 目录下,且必须是 .js 后缀(即使项目用 TypeScript,入口文件也得是 JS)。调用前要在 pages.json 中显式声明:
"mp-weixin": {
"workers": "workers"
}
页面中使用:
const worker = uni.createWorker('workers/calc.js', { useExperimentalWorker: true });
worker.postMessage({ type: 'PROCESS_DATA', data: [1, 2, 3] });
worker.onMessage(res => {
console.log(res.data);
});
// 必须监听被系统杀死的情况,否则后续 postMessage 会静默失败
worker.onProcessKilled(() => {
// 重新创建
worker = uni.createWorker('workers/calc.js');
});
-
useExperimentalWorker: true是保活关键,否则 iOS 微信容易在后台或内存紧张时销毁 Worker - 不能多次调用
uni.createWorker()创建多个实例,旧实例不会自动 terminate,需手动管理或依赖单例封装 - Worker 文件内不能
import其他模块(除非用importScripts加载纯 JS 脚本),也不能调用uni.getSystemInfoSync这类 API
App 端替代方案:plus.threads 是唯一轻量选择
App 端唯一可行的类多线程机制是 plus.threads,但它不是 Web Worker,而是 DCloud 5+ Runtime 提供的原生线程封装。仅限 app-plus 编译目标,且必须启用 5+ 引擎(非 weex 模式)。
创建方式:
const thread = plus.thread.create('_www/js/calc.js');
thread.postMessage({ data: new Float64Array([1, 2, 3]) });
thread.onmessage = e => {
console.log(e.data);
};
// 必须手动退出,否则线程常驻内存
thread.quit();
- 线程内只能用
plus.runtime.quit()、plus.storage等极少数 plus API,无console(部分 Android 机型不输出) - 消息体必须是可序列化的纯对象,
Float64Array.buffer无法直接传,需先.slice()成普通数组 - 不能用 ES Module,
import/export全失效;工具函数得写成 IIFE 或直接内联
数据传递和性能避坑要点
无论哪个平台,Worker 通信本质都是结构化克隆(structured clone),大数组拷贝开销极大。科学计算或图像处理场景必须注意:
- H5 和小程序 Worker 支持
Transferable,例如worker.postMessage({ data: arr.buffer }, [arr.buffer])可零拷贝转移ArrayBuffer,但小程序部分旧版本不兼容,需降级兜底 - App 端
plus.threads不支持Transferable,所有数据都会深拷贝,超 1MB 就明显卡顿,建议拆成小批次或改用原生插件 - 避免高频
postMessage:把「每帧更新进度」改成「每 10% 或每 100 次迭代发一次」,否则通信本身成瓶颈 - 主线程收到结果后,别直接塞进响应式数据(如
this.result = e.data),大量计算结果可能触发 Vue 的依赖追踪风暴,先JSON.parse(JSON.stringify())脱敏再赋值
最易被忽略的一点:Worker 文件里的错误不会自动抛到主线程控制台,onerror 事件只捕获脚本加载失败,真正的运行时异常(如 NaN 传播、除零)必须靠 self.postMessage({ error: 'xxx' }) 主动上报,并在主线程 onmessage 里判断 if (e.data.error) 处理。


















