aiter() 异步迭代器
最后更新：2026-09-22
aiter() 异步迭代器
aiter(async_iterable) 返回异步可迭代对象的异步迭代器。
| 分类 | 内置函数 |
|---|---|
| 类型 | 内置函数 |
| Python 版本 | 3.10+ |
📝 语法
aiter(async_iterable)⚙️ 参数
| iterable 必选 | 异步可迭代对象（async iterable）。 |
|---|
返回值：返回该异步可迭代对象的异步迭代器。
💥 异常
TypeError— 对象不可异步迭代（无 __aiter__）时抛出。
▶ 示例
编辑下方代码，点击运行，在输出面板查看结果：
运行结果：
1🏷️ 相关内置函数
💡 相关案例
更多实战案例即将上线，敬请期待。
❓ 常见问题
Qaiter() 和 iter() 有什么区别？
Aaiter() 是异步版本，返回异步迭代器（支持 __anext__），用在异步可迭代对象上，如 aiter(async_gen())。
Qasync for 和 aiter() 什么关系？
Aasync for 内部就是调用 aiter() + anext() 的组合，如同同步 for 使用 iter() + next()。
Q对普通列表调用 aiter() 会怎样？
A抛 TypeError，list 没有 __aiter__ 方法，不是异步可迭代对象；想异步迭代请用异步生成器或第三方异步容器。
Qaiter() 只能在 async 上下文里调用吗？
A调用本身不强制，但拿到的异步迭代器只能在异步代码里消费（await anext 或 async for）。
