python 3.10对typing模块无破坏性变更，但默认启用延迟求值，__annotations__值为str；需用typing.get_type_hints()获取真实类型；新增x|y语法糖可能不兼容旧工具链。
typing 模块在 Python 3.10 中没有破坏性变更
Python 3.10 对 typing 模块本身没有做任何破坏性修改——所有 3.9 及更早版本中合法的类型提示写法，在 3.10 中仍能正常运行，不会报错或改变语义。
但默认行为变化：from __future__ import annotations 已成冗余
PEP 563 在 3.7 引入延迟求值（即把类型注解存为字符串），需显式加 from __future__ import annotations 才生效；到了 3.10，这变成默认行为，无需导入即可触发。
- 这意味着
__annotations__字典里所有值现在默认是str，不再是已求值的类型对象 - 若你在运行时需要真实类型（比如做动态验证），必须显式调用
typing.get_type_hints(obj)，不能直接访问__annotations__后就当作类型对象用 -
inspect.signature()会尝试解析这些字符串，失败时才回退显示原始字符串——这点容易被忽略，导致调试时看到的签名和预期不符
新增语法糖不兼容旧工具链
3.10 引入了 X | Y 作为 Union[X, Y] 的简写（PEP 604），这是纯语法层增强，但部分旧版类型检查器或 IDE 插件（如 mypy
- 如果你的 CI 流水线跑的是较老的 mypy 版本，
int | str会被当成语法错误，而非类型联合 - 这种“不兼容”不是 Python 解释器层面的，而是工具链滞后所致，升级 mypy ≥ 0.900 即可解决
- 注意：
Optional[X]仍等价于X | None，但后者在 3.10+ 更推荐；不过若项目需兼容 Optional
真正容易踩坑的是运行时反射逻辑
很多库（如 FastAPI、Pydantic v1、dataclasses 初始化逻辑）依赖对 __annotations__ 的直接读取。3.10 默认延迟求值后，它们若没适配 get_type_hints()，就可能拿到字符串却当类型对象用，引发 AttributeError 或静默行为异常。
- 典型症状：函数参数标注了
list[str]，但运行时拿到的是字符串"list[str]"，而代码试图调用.__args__报错 - Pydantic v1 需要
Config.arbitrary_types_allowed = True+ 手动处理，v2 已原生适配 - 自定义的序列化/校验逻辑若硬编码了
isinstance(ann, type)判断，会在 3.10 下失效
最常被忽略的一点：延迟求值是全局默认的，无法局部关闭；哪怕你只在一个文件里写了 from __future__ import annotations，它对整个模块都生效——而 3.10 下它已无实际作用，删掉也不会影响行为，但留着也无害。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
