Node.js核心库Libuv入门教程
Libuv是什么？1.简介Libuv是一个高性能的，事件驱动的异步I/O库，它本身是由C语言编写的，具有很高的可移植性。libuv封装了不同平台底层对于异步IO模型的实现，所以它还本身具备着Windows,Linux都可使用的跨平台能力。Libuv专为Node.js而设计，但是后来因为它这种事件驱动的异步IO的高效模型逐步被很多语言和项目都采纳而作为自身的底层库而使用，像Luvit,Julia,pyuv,还有很多基于它的项目[1]2.Libuv历史Nodejs刚出来的时候，底层并不是使用li
Libuv是一个高性能的，事件驱动的异步I/O库，它本身是由C语言编写的，具有很高的可移植性。libuv封装了不同平台底层对于异步IO模型的实现，所以它还本身具备着Windows, Linux都可使用的跨平台能力。
![[Nodejs原理] 核心库Libuv入门（Hello World篇）](/uploads/20251227/176683970145779.jpg)
Libuv专为Node.js而设计，但是后来因为它这种事件驱动的异步IO的高效模型逐步被很多语言和项目都采纳而作为自身的底层库而使用，像 Luvit, Julia, pyuv, 还有很多基于它的项目[1]
2. Libuv历史Nodejs刚出来的时候，底层并不是使用libuv，而是libev，libev本身也是一个异步IO的库，但是它只能在POSIX[2]系统下使用。随着nodejs被越来越多人使用，由于windows的用户量巨大，所以开始考虑Nodejs的跨平台能力。
这时候Nodejs提供了libuv来作为抽象封装层，在Unix系统上，通过封装libev和libio调用linux的epoll 或 kqueue，在Windows 平台上的IOCP[3]进行封装，自此之后Nodejs具备了跨平台能力，由Libuv作为中间层本身提供的跨平台的抽象，来根据系统决定使用libev/libio或IOCP，后来在node-v0.9.0版本中，libuv移除了libev的内容。
![[Nodejs原理] 核心库Libuv入门（Hello World篇）](/uploads/20251227/176683970159394.jpg)
笔者是MacOS的系统，其他操作系统可以查看官方安装文档[4]，接下下来介绍一下 libuv的安装与使用。
一、安装libuv1.下载libuv的源码
代码语言：javascript代码运行次数：0运行复制git clone https://github.com/libuv/libuv.git2.下载完成后进入项目，依次执行下面命令，进行编译安装，遇到问题 可以在libuv的ISSUE[5] 下寻找答案或者留言提问。
代码语言：javascript代码运行次数：0运行复制sh autogen.sh./configuremakemake checkmake install3.安装完成后，查看一下自己本地 /usr/local/include/ 下是否有uv.h等头文件，如果存在即安装完成。
![[Nodejs原理] 核心库Libuv入门（Hello World篇）](/uploads/20251227/176683970181309.jpg)
4.查看静态链接库文件/usr/local/lib/libuv.a 是否存在。
![[Nodejs原理] 核心库Libuv入门（Hello World篇）](/uploads/20251227/176683970184848.jpg)
下述示例默认有c语言环境，可以输入gcc验证一下，没有c环境的话请搜索安装gcc环境。这边的hello world参考的文档里推荐的入门示例[6]。
1.新建文件 main.c。
代码语言：javascript代码运行次数：0运行复制vim main.c2.文件写入如下内容。
代码语言：javascript代码运行次数：0运行复制// main.c#include #include #include #include int main() { uv_loop_t *loop = malloc(sizeof(uv_loop_t)); uv_loop_init(loop); printf("Now quitting.\n"); uv_run(loop, UV_RUN_DEFAULT); uv_loop_close(loop); free(loop); return 0;} 3.如果提示没有uv.h，可以试试下面的头替代。
代码语言：javascript代码运行次数：0运行复制#include 4.执行编译链接命令。
代码语言：javascript代码运行次数：0运行复制gcc -o main main.c -luv或者gcc -o main main.c /usr/local/lib/libuv.a5.执行可执行文件 ./main 进行验证。
![[Nodejs原理] 核心库Libuv入门（Hello World篇）](/uploads/20251227/176683970161504.jpg)
6.程序解释：首先uv_loop_init开启了一个loop，uv_run执行，但是loop是空的，没有要处理的事件，然后很快uv_loop_close退出。
目前一个使用libuv做的入门实例已完成，接下来笔者将会解析一下内部的Api，做一些实例分享出来，有兴趣的请关注笔者微信公众号哦 。
References[1] Projects that use libuv: https://github.com/libuv/libuv/wiki/Projects-that-use-libuv[2] 是一套操作系统 API 规范。一般而言，遵守 POSIX 规范的操作系统指的是 UNIX、Linux、Mac OS X 等: [3] Windows 平台上的内核事件通知相应的机制Input/Output Completion Port: [4] 安装文档: https://github.com/libuv/libuv#build-instructions[5] ISSUE: https://github.com/libuv/libuv/issues[6] 入门示例: https://github.com/luohaha/Chinese-uvbook/blob/master/source/basics_of_libuv.md#hello-world
如上内容均为自己总结，难免会有错误或者认识偏差，如有问题，希望大家留言指正，以免误人，若有什么问题请留言，会尽力回答之。如果对你有帮助不要忘了分享给你的朋友或者点击右下方的“在看”哦！也可以关注作者，查看历史文章并且关注最新动态，助你早日成为一名全栈工程师！
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
