01 · 函数签名def fn(x: T) -> R
参数与返回值契约化
IDE 自动补全与重构依据,无返回值统一标注 -> None。
02 · 泛型容器PEP 585
直接用内置类作泛型
用 list[int]、dict[str, Any] 替代旧版大写 List/Dict。
03 · 可空约束PEP 604
Optional 与联合管道符
Optional[str] 等价于 str | None,强制调用方判空。
04 · 类型别名PEP 613 / 695
简化复杂嵌套类型
用 TypeAlias 或 3.12 type 关键字复用深层结构。
工程黄金法则:类型注解仅作静态提示,配合 mypy / pyright 方能发挥最大威力。