最可靠方式是用 isinstance(asyncio.get_running_loop(), uvloop.Loop) 判断,需先 try/except 导入 uvloop,并确保在运行中的事件循环上下文中调用。

怎么判断当前 asyncio 事件循环是 uvloop 实例
直接检查 asyncio.get_event_loop() 返回对象的类型是最可靠的方式。uvloop 的事件循环类名为 uvloop.Loop,而标准库用的是 asyncio.events._UnixSelectorEventLoop(Linux/macOS)或 asyncio.windows_events._WindowsSelectorEventLoop(Windows),但这些内部类名不建议硬匹配——应优先用 isinstance 判断。
实操建议:
- 先
import uvloop,再用isinstance(asyncio.get_event_loop(), uvloop.Loop) - 如果未安装 uvloop,导入会失败,所以需加
try/except ImportError包裹 - 不要依赖
repr(loop)或loop.__class__.__name__做字符串匹配,不同 uvloop 版本可能调整类名或模块路径
为什么不能只看 asyncio.get_event_loop_policy()
设置策略(如 uvloop.install())只是影响后续新建 loop 的默认实现,并不改变已存在的 loop 实例。即使调用了 uvloop.install(),若之前已手动创建并运行过标准 loop,get_event_loop() 仍可能返回旧的非-uvloop 实例。
常见错误现象:
- 在
if __name__ == '__main__':外提前调用asyncio.get_event_loop(),触发隐式创建,默认是标准 loop - 使用
asyncio.run()启动协程时,它内部总会新建一个 loop(受当前 policy 控制),但你无法访问那个 loop 对象 - 测试时用
pytest-asyncio等插件,其 fixture 可能复用 loop,导致策略生效与否与预期不符
在异步函数里安全检测当前 loop 类型的写法
由于事件循环可能尚未启动、或处于关闭状态,直接调用 asyncio.get_event_loop() 有风险。推荐用 asyncio.get_running_loop()(Python 3.7+),它只在已有运行中 loop 时返回,否则抛 RuntimeError。
示例代码片段:
import asyncio
try:
import uvloop
except ImportError:
uvloop = None
def is_using_uvloop():
try:
loop = asyncio.get_running_loop()
except RuntimeError:
return False # no running loop
if uvloop is None:
return False
return isinstance(loop, uvloop.Loop)
注意:is_using_uvloop() 必须在协程内或事件循环已启动后调用,否则 get_running_loop() 会直接报错。
uvloop 和标准 loop 的行为差异会影响检测结果吗
不影响检测逻辑本身,但会影响你“何时能检测”和“检测是否有效”。uvloop 不支持 loop.set_debug(True) 的部分调试功能,且某些低层 API(如 loop._selector)根本不存在;标准 loop 在 Windows 上默认用 Proactor,而 uvloop 只支持 Selector 模式(即必须用 SelectorEventLoop 兼容接口)。这意味着:
- 如果你在
asyncio.run()外部、又没显式启动 loop,就调用检测函数,大概率得到False或异常,不是因为不是 uvloop,而是根本没有 loop - 在子进程或线程里调用检测,
get_running_loop()总是失败(loop 是线程局部的),此时检测无意义 - 某些打包工具(如 PyInstaller)可能干扰 uvloop 的 C 扩展加载,导致
import uvloop成功但isinstance(..., uvloop.Loop)永远为False,需要额外验证uvloop.new_event_loop()是否可构造
真正容易被忽略的是:loop 类型不是全局状态,而是每个线程独立、每次 asyncio.run() 独立;检测结果只对当前执行上下文有效,不能缓存复用。










