libuv
Node.js 底层使用的跨平台异步 I/O 库，负责事件循环、I/O 轮询、线程池、定时器、子进程与跨平台系统抽象。
#type / resource
#status / growing
#tech / dev / backend
#resource / libuv
#resource / nodejs
#platform / server
[!info] related notes
libuv
这是什么
libuv 是一个跨平台异步 I/O 库。
在 Node.js 里，它主要负责：
- 事件循环
- 网络 I/O 轮询
- 定时器
- 文件系统任务调度
- DNS 的部分阻塞调用封装
- 子进程与信号处理
- 线程池
如果只用一句话概括：
V8 负责执行 JavaScript，libuv 负责把大量异步系统事件组织成可调度的运行时机制。
适用平台
- Linux
- macOS / BSD
- Windows
- 其他 libuv 支持的平台
它的核心价值之一就是给 Node.js 提供统一的跨平台异步抽象，而不要求 Node 直接暴露每个操作系统自己的 I/O 接口细节。
核心特点 / 优势 / 局限
核心特点
- 封装了跨平台事件循环
- 对网络 I/O 使用各平台合适的轮询机制
- 提供线程池来承接部分阻塞任务
- 用 handle / request 模型维护异步资源生命周期
- 最终把完成事件交回 Node.js，再回到 JavaScript callback
优势
- 让 Node.js 可以用统一模型处理不同平台上的异步 I/O
- 让一个线程管理大量 socket、timer 和系统事件
- 把文件系统、DNS 等不适合直接走 socket poller 的任务统一收口
局限
- 它不是 JavaScript 引擎，不负责执行 JS
- 它不是数据库、网络或文件系统本身，只是调度和抽象层
- 它也不是“所有异步任务都并行”的魔法，线程池大小和事件循环都有限制
在 Node.js 里的位置
粗略心智模型可以先记成：
Node.js = V8 + libuv + C++ bindings + Node 标准库其中：
- V8 负责解析、编译、执行 JavaScript
- libuv 负责事件循环和大量系统级异步调度
- Node.js API 把
fs、net、http、crypto、stream等能力暴露给用户代码
它真正管什么
1. 事件循环
libuv 维护 loop，并按阶段推进：
- timers
- pending callbacks
- idle / prepare
- poll
- check
- close callbacks
但 Node.js 用户看到的“阶段模型”只是其上层表现。更底层的调度、阻塞等待、poll timeout 计算和 alive 判断，属于 libuv 自己的逻辑。
2. 网络 I/O 轮询
libuv 会把 socket 注册到底层 OS poller，然后等待：
- 可读
- 可写
- 连接建立
- 关闭 / 错误
不同平台可能使用不同机制，例如：
- Linux 的
epoll - macOS / BSD 的
kqueue - Windows 的 IOCP
3. Worker Pool
很多文件系统操作和部分 DNS / crypto / zlib 工作，不适合像 socket 那样纯靠 I/O 事件直接完成，于是 libuv 会把它们交给线程池处理，完成后再把 callback 投回事件循环主线程。
4. Handle / Request 生命周期
事件循环为什么继续跑、什么时候可以退出，不是靠“队列里还有没有 callback”这种简化模型判断，而是和 active handles、active requests、closing handles 这些运行时状态有关。
最容易混淆的边界
libuv 不等于 V8
- V8 负责执行 JS
- libuv 负责异步 I/O 调度
libuv 不等于 Promise 微任务
process.nextTick()和 Promise 微任务不属于 libuv 阶段本身- 它们属于 Node / V8 的 JavaScript 调度语义
libuv 线程池不等于 worker_threads
- libuv worker pool 主要给文件系统、DNS、部分
crypto/zlib等内部任务用 - worker-threads 是用户可直接创建的 JavaScript 并行线程模型，主要处理 CPU 密集型逻辑
常见用途
- 承接 Node.js 的 TCP / UDP / pipe / timer 等底层异步能力
- 支撑文件系统、DNS、子进程等异步 API
- 为 Node.js 提供跨平台事件循环和线程池抽象
相关链接 / 官方入口
- 运行时架构：Node.js 运行时架构
- 详细机制：libuv 事件循环与 Worker Pool
- 阶段视图：Node.js 事件循环阶段
- 官方：https://libuv.org/