# Node.js worker_threads 参考

URL: https://caijiao.org/reference/nodejs/worker-threads
Source: docs/reference/nodejs/worker-threads.md
Description: Node.js worker_threads Reference，整理常见语法、ESM 示例、CommonJS 差异、常见错误和相关 Node.js 生态链接。

Node.js worker_threads 是 Node.js 核心能力的一部分。ESM 中推荐使用 `node:` 前缀导入；CommonJS 中可使用 `require("node:worker_threads")`。

## 语法

```text
new Worker(filename[, options])
```

## 最小示例

```js
import { Worker, isMainThread } from 'node:worker_threads';
if (isMainThread) new Worker(new URL(import.meta.url));
```

## 常见错误

- 混用 ESM 与 CommonJS，导致导入方式不一致。
- 忽略异步错误，未使用 try/catch 或错误事件处理。
- 把示例路径写死到特定系统，导致 Windows 和 Linux 表现不同。

## 相关内容

- [Express 教程](/express/)
- [Fastify 教程](/fastify/)
- [PM2 教程](/pm2/)
- [Docker Reference](/reference/docker/)