Node.js 异步任务调度:nextTick、setImmediate 与 setTimeout

在明确的运行条件下判断任务顺序,并避免依赖不稳定的计时关系。

🎯 引言

学完这篇文章,你能在明确的运行条件下判断任务顺序,并避免依赖不稳定的计时关系。


🧱 先明确运行条件

本篇统一使用 Node.js 24.19.0 的 ESM(.mjs)示例。 每段独立保存并运行;判断顺序时注意任务是在模块顶层还是 I/O 回调中登记。

setTimeout 表示满足等待条件后执行,setImmediate 表示在 check 阶段执行,process.nextTick 则进入当前操作结束后优先处理的专用队列。


⏱️ nextTick:当前代码结束后执行

保存为 tick.mjs,运行 node tick.mjs:

tick.mjs
process.nextTick(() => console.log('nextTick'))
console.log('同步代码')

先输出 同步代码,再输出 nextTick。它的用途是把工作推迟到当前同步操作之后,但通常会在事件循环继续推进普通阶段之前处理。

不要递归地不断往这个队列添加任务:如果队列一直没有处理完,文件、网络等 I/O 就可能长时间得不到机会。


⚖️ ESM 顶层:Promise 回调先于 nextTick

本例是 ESM 文件的顶层代码,也就是直接写在文件中、没有放进其他回调的代码。 保存为 microtasks.mjs:

microtasks.mjs
Promise.resolve().then(() => console.log('Promise'))
process.nextTick(() => console.log('nextTick'))

运行 node microtasks.mjs,先输出 Promise,再输出 nextTick。ESM 顶层代码在异步模块加载流程中执行,这里登记的 Promise 回调会先得到处理机会。

如果在其他资料中看到“nextTick 先于 Promise”,先确认示例环境:同样两行代码在 CJS 顶层会先输出 nextTick,在本课程使用的 ESM 顶层则先输出 Promise。两者的模块执行方式不同,并不矛盾。

这里的结论只针对顶层示例,不能直接套用到文件读取等回调内部。


🕒 timeout 与 immediate:顶层不保证谁先

保存为 timers.mjs:

timers.mjs
setTimeout(() => console.log('timeout'), 0)
setImmediate(() => console.log('immediate'))

可能先看到 timeout,也可能先看到 immediate。0 仍然需要定时器满足运行条件,进入事件循环时的实际时间会影响观察结果。多次运行偶然顺序相同,也不代表形成了可依赖的保证。

setImmediate 名称中虽然有“立即”,实际仍要等到 check 阶段。它同样不会打断正在执行的代码。


📂 I/O 回调里的顺序有明确前提

上一章事件循环已经演示:在同一个文件读取回调里登记两者,setImmediate 先于 setTimeout 执行。与本篇顶层示例相比,区别在于登记位置;不能脱离这个前提背诵固定顺序。


🧰 业务依赖要明确等待

日常文件和网络任务通常直接等待对应 API 的结果,不需要为了“变成异步”额外套一层调度函数。

当前目的处理方式
读取完成后再使用内容等待 readFile 的 Promise,或在完成回调中处理
隔一段时间再重试使用 setTimeout;延迟只是等待下限,不是精确执行时间
把可拆分的计算分批执行,让 I/O 有机会运行每批结束后用 setImmediate 安排下一批;每一批本身仍不能执行太久

nextTick 的顺序比较用于理解已有代码,不应把它当成业务代码默认的异步入口。它会优先清空自己的队列,反复安排任务可能推迟 I/O。

写文件后再读文件,应等待写入完成,再调用读取;不要用 setTimeout(..., 0) 猜测文件应该已经写完。nextTick 和 setImmediate 也不是用来证明另一项 I/O 已完成的。


❓ 知识问答

Q1:nextTick 一定比 Promise 先吗?

不是,本篇 ESM 顶层示例中 Promise 回调先执行;判断时要确认任务登记的位置。

Q2:为什么 I/O 回调里的顺序不能直接用于顶层代码?

I/O 回调执行后有明确的后续阶段位置,顶层注册时还涉及进入循环的时间条件,二者前提不同。

Q3:一直递归 nextTick 能提高吞吐吗?

反而可能阻止事件循环推进,让 I/O 长时间得不到处理。


🧪 小练习

交换 microtasks.mjs 中两行代码的顺序,再运行并记录结果,检查登记顺序是否决定了本例的执行顺序。

// 请在这里编写代码

🎉 现在可以用自己的例子验证这些用法啦!