Python 3.5+ 中生成器内显式 raise StopIteration 会被自动转为 RuntimeError，这是 PEP 479 规定的强制行为，旨在防止 StopIteration 逃逸出生成器协议；唯一合规的提前退出方式是 return，其值作为 StopIteration.value 可被捕获。
StopIteration 在生成器内部被 raise 时不再冒泡，是 Python 3.5+ 的强制行为，不是 bug，也不可关闭。
为什么 raise StopIteration 在生成器里不生效
因为 PEP 479 明确要求：生成器函数体中任何显式 raise StopIteration（无论带不带参数）都会被解释器自动拦截，并包装成 RuntimeError: generator raised StopIteration。这是为了防止 StopIteration “逃逸”出生成器协议边界，干扰 for 循环或 next() 的正常终止逻辑。
常见错误现象包括：
- 你写了
raise StopIteration("done")，但没看到StopIteration报错，反而卡住或抛出RuntimeError - 在
yield from或嵌套生成器中手动raise StopIteration，结果上层收到的是RuntimeError而非预期的StopIteration - 用
try/except StopIteration包裹生成器创建逻辑（如生成器表达式），却捕获不到异常——因为异常实际发生在迭代时，而非定义时
正确提前退出生成器：只用 return
return 是唯一安全、符合协议的提前终止方式。它会触发 StopIteration，且返回值会作为 StopIteration.value 可被外部捕获。
立即学习“Python免费学习笔记（深入）”；
对比行为：
-
return→ 触发StopIteration，.value为None -
return 42→ 触发StopIteration，.value为42 -
raise StopIteration→ 被转为RuntimeError，原始信息丢失 -
raise StopIteration(42)→ 同样转为RuntimeError，42不可用
示例：
def safe_gen():
yield "a"
yield "b"
return "done" # ✅ 正确：调用 next() 后会得到 StopIteration(value="done")
<p>g = safe_gen()
print(next(g)) # "a"
print(next(g)) # "b"
try:
next(g)
except StopIteration as e:
print(e.value) # "done"
在生成器表达式或 yield from 中捕获耗尽异常要格外小心
生成器表达式（如 (next(it) for _ in range(n))）是惰性的，next() 调用延迟到实际迭代时才发生。这意味着：
- 外部
try/except StopIteration写在生成器定义处，根本捕获不到内部next()抛出的异常 - 异常实际发生在下游消费端（比如
for x in part:），此时原try块早已退出作用域 - Python 3.7+ 会把这种未被生成器内部处理的
StopIteration自动转为RuntimeError，并带上__cause__指向原始StopIteration
解决思路是：把异常处理移到真正调用 next() 或迭代子生成器的地方，而不是在构造时。
协程和异步生成器也遵循同一规则
async def 定义的协程或异步生成器中，raise StopIteration 同样被禁止。PEP 492 明确规定：协程不抛出 StopIteration，而是由解释器统一转换为 RuntimeError。
如果你在 async for 或 await anext() 场景下遇到类似问题，检查是否误用了 raise StopIteration —— 应该用 return 或直接让协程自然结束。
容易被忽略的一点是：yield from 委派生成器时，子生成器的 return value 会成为委派生成器的 StopIteration.value；但若子生成器 raise StopIteration，则整个链路都会变成 RuntimeError，且无法还原原始意图。
