setImmediate 不阻塞主线程，用于将 I/O 回调中的同步任务推迟至 check 阶段执行，避免主线程卡顿；它不引入 1ms 延迟、不占用定时器资源，但不可替代异步 I/O 操作。

setImmediate 本身不阻塞主线程，但它在 I/O 回调中合理使用，能帮你在不打断事件循环节奏的前提下，把后续逻辑“让出”给 check 阶段执行，从而避免同步堆积导致的卡顿。

I/O 回调里别直接写重逻辑

文件读取、网络响应等 I/O 完成后，回调函数立即执行。如果里面塞了大量计算、模板渲染或同步数据库操作，主线程就会被占住，其他请求和 I/O 就得排队。

• ❌ 错误做法：fs.readFile('config.json', (err, data) => { parse(data); initServices(); sendMetrics(); });
• ✅ 正确做法：fs.readFile('config.json', (err, data) => { setImmediate(() => { parse(data); initServices(); sendMetrics(); }); });

用 setImmediate 把同步任务“推后一步”

它不会跳过当前事件循环，而是确保这些操作在 poll 阶段（I/O 处理）结束后、定时器阶段之前执行。这样既没延迟到下一轮循环，又避免了和 I/O 回调抢时间。

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

• 它不引入最小 1ms 延迟（不像 setTimeout(0)）
• 它不占用定时器资源，也不触发 libuv 的 timer heap 管理开销
• 语义清晰：“I/O 刚做完，现在轮到我了”

注意边界：别把它当异步 IO 用

setImmediate 不会帮你做文件读、发 HTTP 请求或查数据库——那些必须用真正的异步 API（如 fs.promises.readFile、fetch、pg.query）。它只负责调度你已准备好的回调。

• ⚠️ 千万别写：setImmediate(() => fs.readFileSync('huge.log')); —— 这仍然阻塞主线程
• ✅ 应该写：fs.readFile('huge.log', (err, data) => { setImmediate(() => process(data)); });

高频场景要加节制

比如日志写入、监控上报这类每秒多次的 I/O 回调，如果每个都调一次 setImmediate，check 阶段容易积压，反拖慢 poll 阶段处理新 I/O 的速度。

• 可合并：用队列暂存，setImmediate 里批量处理
• 可降频：对非关键路径，改用 setTimeout(0, { once: true }) 或简单延后几毫秒
• 可清理：不再需要的任务，记得用 clearImmediate() 释放引用