类方法加async需配合await调用，否则返回协程对象不执行；async修饰不影响绑定逻辑，但实例/类/静态方法语义不同；异步上下文管理器须实现__aenter__/__aexit__；继承中异步方法覆盖需注意返回类型一致性。
类方法里直接加 async 就行，但调用方式必须匹配
类方法加 async 本身没问题，Python 允许 async def 出现在类定义中，生成的是协程方法（coroutine method），不是普通可调用对象。这意味着你不能像调用同步方法那样直接写 obj.method()，否则返回的是一个 coroutine 对象，不 await 就不会执行。
- 错误写法：
obj.fetch_data()→ 返回<coroutine object ...></coroutine>，什么也不发生 - 正确写法：
await obj.fetch_data()，且该调用必须在async函数或asyncio.run()中 - 如果想在同步上下文中调用，得用
asyncio.run(obj.fetch_data())，但不推荐——每次调用都启停事件循环，开销大
实例方法、类方法、静态方法的 async 行为差异
async 修饰符只改变函数体的执行模型，不影响绑定逻辑。但三者语义不同，容易混淆：
-
async def instance_method(self)：标准异步实例方法，self可访问实例状态，需await obj.m() -
@classmethod+async def class_method(cls)：语法合法，但cls是类对象，无法隐式 await；调用仍需await MyClass.class_method() -
@staticmethod+async def static_method()：等价于顶层异步函数，无绑定，但依然返回协程，必须 await
注意：@classmethod 和 @staticmethod 不改变 async 的本质——它们只是让函数能被类/实例访问，不解决调度问题。
带 __aenter__/__aexit__ 的异步上下文管理器要显式实现
如果类需要支持 async with，不能只靠 async 方法，必须实现异步生命周期钩子：
立即学习“Python免费学习笔记（深入）”；
提示词大师-python版
下载
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- 必须定义
async def __aenter__(self)和async def __aexit__(self, *exc) -
__aenter__应返回需要被绑定的对象（通常是self），且内部可 await 初始化操作 - 遗漏任一方法会导致
TypeError: object X is not an async context manager
示例片段：
class AsyncDBConnection:
def __init__(self, url):
self.url = url
self.conn = None
<pre class='brush:python;toolbar:false;'>async def __aenter__(self):
self.conn = await connect(self.url) # 假设 connect 是异步的
return self
async def __aexit__(self, exc_type, exc_val, exc_tb):
if self.conn:
await self.conn.close()然后才能用：async with AsyncDBConnection("sqlite:///db.db") as db:
继承与多态下异步方法的覆盖要小心返回类型一致性
子类重写父类的异步方法时，Python 不强制检查协程返回值类型，但若父类方法声明返回 str，子类返回 int 或没 await 就 return，运行时可能出错或逻辑错乱。
- 常见坑：子类里忘了
await父类方法，直接return super().fetch()→ 返回协程对象而非实际数据 - 建议统一用类型提示：
async def fetch(self) -> str:，配合 mypy 检查（mypy 目前对 async 支持有限，但至少能捕获明显 mismatch） - 若父类是同步方法，子类改成异步，调用方代码必须整体改造，无法透明替换
异步和同步混用边界最脆弱，一旦跨层调用没对齐 await 链，就会卡住或抛 RuntimeWarning: coroutine 'X' was never awaited。
