uvloop是基于libuv和cython实现的asyncio高性能事件循环替代品，实测吞吐量为默认selectoreventloop的2–4倍，尤其适用于高并发i/o场景；它通过替换底层调度逻辑显著降低python解释器开销，但不提升cpu密集型任务性能。
uvloop 是什么，为什么值得换
uvloop 是 asyncio 的高性能替代事件循环，底层用 C++ 和 libuv 实现，实测吞吐量通常是默认 asyncio.SelectorEventLoop 的 2–4 倍，尤其在高并发 I/O 场景（如 Web 服务、爬虫、消息代理）中优势明显。但它不是万能加速器——纯 CPU 密集型协程不会变快，反而可能因额外调度开销略慢。
如何全局替换 asyncio 默认事件循环
最常用也最稳妥的方式是在程序入口处调用 uvloop.install()，它会劫持 asyncio.new_event_loop() 和 asyncio.get_event_loop_policy()，后续所有新建的事件循环都会是 uvloop 实例。
必须注意：这个操作只能在事件循环创建前执行，且仅一次有效。常见错误包括：
- 在已运行的事件循环中调用（会抛
RuntimeError: Event loop is running） - 在
import asyncio之后、但未调用任何 asyncio 函数前就 import uvloop —— 没问题；但如果已经调用了asyncio.get_event_loop()再 install，就无效 - 在子进程或线程里重复 install —— 不需要，也不推荐
示例：
import uvloop import asyncio <p>uvloop.install() # 必须放最前面，且只调用一次</p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill8393" title="Forge — Python Developer"><img src="https://img.php.cn/upload/skill/000/000/081/179203503734063.jpg" alt="Forge — Python Developer" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a rel="nofollow" href="/xiazai/skill8393" title="Forge — Python Developer" class="overflowclass">Forge — Python Developer</a> <p class="overflowclass">Python开发助手 — 自动化脚本、API封装、命令行工具、数据管道、网页爬虫。经过测试的代码，包含错误处理和文档。当你需要...</p> </div> <a rel="nofollow" href="/xiazai/skill8393" title="Forge — Python Developer" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div><p>async def main(): await asyncio.sleep(1)</p><p>asyncio.run(main()) # 自动使用 uvloop </p>
手动创建 uvloop 实例并传入 run_xxx
当需要精细控制（比如测试对比、嵌入已有框架），可以跳过 install()，直接构造 uvloop.Loop 实例：
-
asyncio.run(coro, loop_factory=uvloop.new_event_loop)—— Python 3.7+ 支持，简洁可靠 -
loop = uvloop.new_event_loop(); asyncio.set_event_loop(loop); loop.run_until_complete(coro)—— 更底层，适合老版本或特殊集成
注意：uvloop.new_event_loop() 返回的是 uvloop.Loop 实例，不是 asyncio.AbstractEventLoop 子类的“普通”对象，但完全兼容 asyncio 接口。
哪些地方不能用 uvloop
uvloop 不支持 Windows（官方明确不维护），在 macOS 上需确保 libuv 版本 ≥ 1.40；更重要的是，部分依赖私有事件循环 API 的库会出问题，典型表现是：
- 调用
loop._selector或loop._process_events等下划线方法时 AttributeError - 使用
asyncio.ProactorEventLoop特性（如 Windows 上的管道、子进程）—— uvloop 是基于 epoll/kqueue 的，没有 proactor 模式 - 某些调试工具（如
aiodebug）或 monkey patch 工具（如gevent兼容层）可能失效
如果你用的是 FastAPI / Starlette / HTTPX / aiohttp，默认已适配 uvloop；但若项目里混用了 asyncio.subprocess 或自定义 selector 调度逻辑，得先验证再上线。
替换本身很简单，真正花时间的是验证边界行为是否一致 —— 尤其是超时、取消、信号处理和异常传播路径。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
