李昦1. 项目概述
在Node.js的多线程开发中，Worker Threads模块为我们提供了强大的多线程能力。其中workerData这个看似简单的参数传递机制，实际上蕴含着不少值得深挖的技术细节。今天我就结合自己踩过的坑，聊聊如何高效利用workerData在不同线程间传递数据。
workerData是Node.js Worker Threads模块中用于主线程向工作线程传递初始化数据的核心机制。与传统的postMessage通信方式不同，workerData在创建工作线程时就完成了数据传递，这种"一次性"的数据传递方式特别适合初始化配置、静态资源等不需要频繁更新的数据场景。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心原理与工作机制
2.1 workerData的底层实现
workerData的实现基于Node.js的序列化机制。当主线程创建Worker时，workerData会通过v8的序列化API被序列化为二进制数据，然后通过IPC通道传递给工作线程。在工作线程端，Node.js会反序列化这些数据并挂载到workerData属性上。
这个过程有几个关键点需要注意：
- 序列化使用的是v8的默认序列化策略
- 数据是通过进程间通信(IPC)传递的
- 传递是单向的（仅主线程→工作线程）
2.2 与postMessage的对比
| 特性 | workerData | postMessage |
|---|---|---|
| 通信方向 | 单向(主→工作) | 双向 |
| 调用时机 | Worker创建时 | 任何时候 |
| 序列化方式 | v8默认 | Structured Clone |
| 适用场景 | 初始化数据 | 运行时通信 |
| 性能 | 一次性开销 | 每次调用都有开销 |
3. 实战应用与代码示例
3.1 基础使用模式
最基本的workerData使用方式如下：
javascript复制const { Worker } = require('worker_threads');
// 主线程
const worker = new Worker('./worker.js', {
workerData: {
config: { timeout: 5