首页/开发/代码质量与评审速查/Python 类型注解关键 PEP
规范与静态检查65 条

Python 类型注解关键 PEP

类型注解四件套:PEP 484(typing 基础)、PEP 585(内置泛型 list[int])、PEP 604(X | Y 联合类型)、PEP 695(类型参数语法,3.12+)。

PEP 484typing 模块与基础注解(3.5+)
PEP 585内置容器泛型写法(3.9+)
PEP 604X | Y 联合类型(3.10+)
PEP 695类型参数语法 def f[T](3.12+)

现代写法

现代写法
def first[T](items: list[T]) -> T | None:  # 3.12+ 可直接运行
    return items[0] if items else None
跨版本兼容可配合 from __future__ import annotations 延迟注解求值。

易错点

  • typing.List 与 list 混用:同一代码库两套风格
  • 运行时依赖注解对象(未开 future import):版本间行为不一致

数据来源与参考

  • PEP 484 / 585 / 604 / 695(python.org)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌