async with 是异步上下文管理器的唯一语法，要求对象实现 __aenter__ 和 __aexit__（非同步版），常见错误包括漏写 a 前缀、未用 await、参数缺失或返回值错误；第三方库如 asynccontextmanager 仅封装协议，不绕过实现；需注意嵌套退出顺序、取消风险、性能开销及测试须用异步函数。
async with 是 async context manager 的唯一入口
Python 里 async with 就是异步上下文管理器的语法糖，没有别的替代写法。它要求对象实现 __aenter__ 和 __aexit__，而不是同步的 __enter__/__exit__。漏掉 a 前缀是新手最常犯的错——写了 __enter__ 却用 async with，直接报 TypeError: object does not support async context manager protocol。
常见错误现象：RuntimeWarning: coroutine 'MyClass.__aenter__' was never awaited，说明你返回了协程但没在 __aenter__ 里用 await；或者 __aexit__ 返回了非布尔值（比如忘了加 return False）导致异常吞没。
- 必须用
async def __aenter__(self)，不能是普通def -
__aexit__必须带三个参数：exc_type, exc_value, traceback，且需显式返回True才抑制异常 - 类不能同时靠
__enter__支撑with和__aenter__支撑async with——得各自实现
aiostream、asyncstdlib 等第三方库不解决协议问题
有人想用 asyncstdlib.contextlib 或 aiostream.stream 绕过手写协议，但这些只是工具集，不是魔法。它们内部照样依赖 __aenter__/__aexit__。比如 asynccontextmanager 装饰器，本质就是帮你生成符合协议的类实例，底层仍是那两个方法。
使用场景：快速包装一个异步初始化+清理逻辑，比如打开异步数据库连接再关闭。
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
-
@asynccontextmanager要求被装饰函数是async def，且yield前后都得是 awaitable - yield 后的代码在
__aexit__中执行，如果这里抛异常，会覆盖原异常，除非显式处理 - 别在
asynccontextmanager里调用同步阻塞操作（如time.sleep），否则整个 event loop 被卡住
嵌套 async with 的顺序和取消风险
多个 async with 嵌套时，退出顺序是倒序——最后进入的最先退出。这点和同步 with 一致，但异步下容易被忽略的是：如果某个 __aexit__ 内部 await 耗时长，或被 cancel，会影响外层退出时机。
性能影响：每个 async with 块都会增加一次协程调度开销，高频短生命周期资源（比如每次 HTTP 请求都新建一个 session）不如复用对象 + 显式 await session.close()。
- 避免在
__aexit__里做重试或网络请求，失败就失败，别拖慢整体退出 - 若资源关闭本身可能超时（如远端服务无响应），应在
__aexit__中加asyncio.wait_for并捕获TimeoutError - 不要指望
async with自动处理 task cancellation——__aexit__被中断时，不会自动回滚已做的清理
测试 async context manager 得用 async test 方法
用 pytest 或 unittest 测异步上下文管理器时，测试函数本身必须是 async def，且要用 await 进入上下文。写成普通函数直接调 async with 会报 SyntaxError: 'async with' outside async function。
可给出简短示例：
async def test_db_connection():
async with DatabasePool() as db:
result = await db.fetch("SELECT 1")
assert result == [(1,)]
- pytest 需安装
pytest-asyncio插件，并标记测试函数为@pytest.mark.asyncio - 别在测试里用
loop.run_until_complete手动驱动——现代测试框架已封装好 event loop 生命周期 - mock 异步方法时，用
AsyncMock（Python 3.8+）或asynctest，普通Mock不会 await
