uvloop是基于libuv的asyncio事件循环替代实现，用Cython封装，性能比默认循环快2–4倍，因其底层为C语言实现、系统调用更少、调度更紧凑，但仅适用于高并发IO场景，不提升CPU密集型任务性能。
uvloop 是什么，为什么它比 asyncio 默认循环快？
uvloop 是 asyncio 事件循环的 CPython 替代实现，底层用 Cython 封装了 libuv（Node.js 同款异步 I/O 引擎）。它不改变 asyncio 的 API，但把 asyncio.BaseEventLoop 的核心调度、IO 多路复用、定时器等逻辑重写为高性能 C 扩展。实测在高并发网络请求、大量短生命周期 task 场景下，吞吐量常提升 2–4 倍，延迟毛刺更少。
不过 uvloop 只支持 Linux/macOS，Windows 下会静默回退到默认 loop（或报错，取决于版本）；且它不兼容某些依赖纯 Python loop 内部细节的库（比如极少数自定义 selector 或 patch 过 _run_once 的调试工具）。
要启用它，关键不是“安装后自动生效”，而是显式替换事件循环策略或直接设置新 loop。
如何正确安装并全局替换 asyncio 默认事件循环？
pip install uvloop 安装后，不能只靠 import 就生效。必须在创建任何 asyncio 任务前完成替换，否则会报 RuntimeError: Cannot run the event loop while another loop is running。
- 最稳妥的方式是在程序入口（如
if __name__ == "__main__":下）第一行调用：import uvloop asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())
- 如果用了
asyncio.run()（Python 3.7+），它内部会新建 loop，此时上述策略已足够——asyncio.run(main())就会使用 uvloop - 避免在 Jupyter 或交互式环境中多次执行该设置，可能触发 loop 策略重复注册错误；可加
try/except ImportError和判断是否已设置
什么时候不该用 uvloop？常见踩坑点有哪些？
uvloop 不是银弹。以下情况建议绕过：
- 代码里显式调用了
asyncio.get_event_loop()并假设它是asyncio.SelectorEventLoop子类（比如手动调用.add_reader()），uvloop 返回的是uvloop.Loop，不支持这些低阶 API - 使用了
asyncio.ProactorEventLoop特性（如 Windows 上的子进程通信、管道），uvloop 不提供 proactor 实现 - 依赖某些调试工具，例如
aiodebug或自定义 loop hook，它们可能未适配 uvloop 的 C 层调度时机 - 单元测试中 mock 了 loop 行为，uvloop 的 C 实现会让部分 mock 失效
另外，uvloop 的日志级别默认更高，若看到大量 DEBUG 级 “timer canceled” 日志，不是错误，是它更激进地清理待取消定时器——可通过 logging.getLogger("uvloop").setLevel(logging.WARNING) 抑制。
在 FastAPI / Quart / aiohttp 中怎么启用 uvloop？
主流异步 Web 框架大多通过 asyncio.run() 或自建 loop 启动，因此只需确保 uvloop 策略在 app.run() 或 serve() 之前设置。
例如 FastAPI：
import uvloop
import asyncio
from fastapi import FastAPI
<p>asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())
app = FastAPI()</p><p>@app.get("/")
async def root():
return {"message": "Hello World"}</p><h1>注意：这里不能用 uvicorn.run() 包裹后再设策略——顺序反了</h1><h1>正确做法是让 uvicorn 自己用新策略，或改用：</h1><p>if <strong>name</strong> == "<strong>main</strong>":
import uvicorn
uvicorn.run(app, host="0.0.0.0:8000", loop=asyncio.get_event_loop())</p>
但更推荐方式是不传 loop 参数，直接靠策略生效；Uvicorn 20.0+ 默认尊重全局 policy。若用旧版，可加 --loop uvloop 启动参数。
真正容易被忽略的是：uvloop 加速效果高度依赖你的实际 workload —— 如果大部分时间花在 CPU 密集型协程（比如没用 loop.run_in_executor 的 JSON 解析、正则匹配），换 uvloop 几乎没差别。它只加速事件循环本身的调度和 IO 等待。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
