exceptiongroup是python 3.11引入的结构化异常容器，本质是表达并发失败语义的树状异常组，非简单拼接；它与普通异常不在同一继承链，无法用传统except捕获其子异常，必须用except*语法解包处理。
ExceptionGroup 是什么，和普通异常有什么本质区别
ExceptionGroup 不是多个异常的简单打包，而是 Python 3.11 引入的结构化异常容器，用来表达“一组并发失败”这一语义。它和 BaseExceptionGroup 一起构成新的异常层次，和传统单异常（如 ValueError）不在同一继承链上——这意味着用 except ValueError: 捕不到它里面的 ValueError，哪怕那个 ValueError 确实存在。
常见错误现象：
- 启动
asyncio.gather(..., return_exceptions=False)抛出ExceptionGroup，但写except ValueError:完全不生效 - 手动构造
ExceptionGroup("oops", [ValueError("a"), TypeError("b")])后，直接raise，外层却只看到ExceptionGroup而不是具体子异常
关键判断：如果你在处理协程批量任务、或使用 concurrent.futures + ExceptionGroup 兼容封装，就必须按新模型来，不能沿用旧的 except 套路。
用 except * 捕获子异常，而不是 ExceptionGroup 本身
except * 是专为解包 ExceptionGroup 设计的语法，它不匹配 ExceptionGroup 实例，而是直接匹配其内部的子异常类型。
使用场景：你想对不同子异常做差异化处理，又不想手动遍历 eg.exceptions。
示例：
try:
raise ExceptionGroup("load failed", [
OSError(2, "No such file"),
ValueError("invalid JSON"),
OSError(13, "Permission denied")
])
except * OSError as eg:
print(f"OS errors: {len(eg.exceptions)}")
except * ValueError as eg:
print(f"Value error: {eg.exceptions[0]}")
注意点：
-
except *分支拿到的eg是一个子集的 ExceptionGroup（比如只含所有OSError），不是原始那个 - 不能混用
except和except *在同一个try块里；要么全用传统方式，要么全用星号方式 -
except *不捕获非ExceptionGroup的异常；如果可能抛出单异常，得额外加普通except分支
如何安全地降级兼容老代码（Python
ExceptionGroup 和 except * 在 Python 3.10 及更早版本中根本不存在，所以不能直接 import 或使用。
可行做法：
- 不要在公共库中直接抛
ExceptionGroup，除非明确要求最低 Python 3.11 - 若必须支持多版本，用
sys.version_info >= (3, 11)动态分支，在老版本中退化为抛出第一个异常（如raise excs[0]）或自定义聚合异常类 - 使用
exceptiongroup第三方 backport 包（PyPI 上同名），它在旧版本中提供兼容实现，但要注意其except *仍不可用——只能用.split()手动分拣
性能影响：
-
ExceptionGroup构造本身开销略高于单异常（要维护子异常列表），但通常可忽略 -
except *的匹配逻辑比普通except稍重，因需遍历子异常并分类，不过实际中差异微乎其微
调试时怎么快速看到所有子异常详情
默认打印 ExceptionGroup 只显示顶层消息和子异常数量，看不出具体内容，容易误判。
推荐做法：
- 用
traceback.print_exception()直接输出完整结构：import traceback try: ... except BaseException as e: traceback.print_exception(e)
- 或者手动展开：
eg.exceptions是个元组，可遍历打印repr(exc)或调用traceback.format_exception_only(type(exc), exc) - VS Code / PyCharm 新版已支持
ExceptionGroup展开调试，但需确认 Python 解释器版本和插件更新
最容易被忽略的一点：即使你用了 except <em></em>，如果没处理完所有子异常（比如只写了 except OSError，但 ExceptionGroup 里还有 ValueError），未被捕获的部分会自动重新聚合成一个新的 ExceptionGroup 并继续向上抛——这不是 bug，是设计使然，但容易让人困惑“为什么还报错”。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
