python 3.12 推荐用 typing.typealias = x 替代字符串前向引用，禁用 node = "treenode"；ast.unparse() 仅适用于调试，生产级代码生成需用 libcst；启用 future.annotations 后 get_type_hints() 返回 forwardref，须显式求值；except* 专用于并发异常分组捕获，不适用于普通异常。
用 typing.TypeAlias 替代字符串字面量类型提示
Python 3.12 正式支持 typing.TypeAlias 作为第一类类型别名声明机制，它比旧的 Foo = "Bar" 或 Foo: TypeAlias = "Bar" 更安全、更可静态分析。
常见错误是继续用字符串前向引用写法，比如 Node = "TreeNode" —— 这在 mypy 1.8+ 和 pyright 1.1.300+ 中已被标记为弃用，且无法被 IDE 正确跳转或补全。
实操建议：
- 把所有类似
Tree = "BinaryTree"的赋值，改为Tree: TypeAlias = BinaryTree（注意：右边必须是已定义的类型，不能是字符串） - 如果右边确实是前向引用（比如循环依赖），用
from __future__ import annotations+ 直接写类名，不再需要引号 - 不推荐混用：旧版
from typing import TypeAlias在 3.12 中仍可用，但标准库路径已变为typing.TypeAlias，保持统一
ast.unparse() 在代码生成中是否可靠
ast.unparse() 在 3.12 中修复了多个边缘 case（如带装饰器的 async 函数、嵌套括号缩进），但它依然不是“源码保真”工具 —— 输出不一定和原始输入格式一致，也不保证能被 Python 解析回原 AST。
立即学习“Python免费学习笔记（深入）”；
典型误用场景是拿它做自动重构脚本的最终输出环节，结果引入意外空格、换行或括号风格变化，导致 git diff 泛滥或 type checker 报告新错误。
实操建议：
- 只用它做“可读性优先”的调试输出，比如
print(ast.unparse(node))查看 AST 对应逻辑 - 生产级代码生成（如 ORM 模型转 Pydantic 类）必须用
libcst或astor这类保留格式的库 - 若坚持用
unparse，务必加 round-trip 校验：解析 → 修改 → unparse → 再解析，确保 AST 等价
启用 __future__.annotations 后，get_type_hints() 行为变化
3.12 默认启用 from __future__ import annotations（PEP 649），这意味着所有注解都延迟求值，get_type_hints() 不再自动 eval 字符串，而是直接返回原始 AST 节点或未求值的 ForwardRef。
最常踩的坑是框架里手动调 get_type_hints(func) 做依赖注入，结果拿到 ForwardRef('User') 却没调 forward_ref.evaluate()，直接 str() 一把就报错。
实操建议：
- 不要假设
get_type_hints()返回的是“可用类型”，检查返回值是否为ForwardRef实例 - 用
typing.get_origin()和typing.get_args()替代直接访问__args__，它们能正确处理未求值注解 - 测试时在函数上显式加
@typing.no_type_check不解决问题，要改逻辑而非绕过
3.12 的 ExceptionGroup 和 except* 在真实并发场景怎么落地
ExceptionGroup 不是给单个 try/except 加糖用的，它的价值在结构化处理并发任务失败 —— 比如 asyncio.gather(..., return_exceptions=True) 返回的混合异常列表，以前得靠手写匹配逻辑，现在能用 except* ValueError 精准捕获子集。
但直接把 except* 塞进老代码会出问题：它只匹配 ExceptionGroup 内部的 *子异常*，对普通异常完全静默；而且嵌套 ExceptionGroup 时，外层 except* 不会穿透到内层。
实操建议：
- 只在明确使用
asyncio.gather、concurrent.futures.as_completed或exceptiongroup.ExceptionGroup构造的场景下引入except* - 避免在顶层
main()或 API 入口盲目加except* BaseException，它不会捕获非 group 异常，反而掩盖问题 - 日志记录时别只打
str(exc)，要用exc.exceptions显式展开，否则看不到具体哪个子任务失败
实际推进时，最容易被忽略的是类型检查器和运行时行为的错位 —— mypy 可能已经支持某个 3.12 特性，但你用的 uvloop 或 pytest 插件还没适配，结果 CI 通过、本地跑挂。上线前至少在真实依赖组合里跑一次 python -m py_compile + 小范围灰度。
