【Python】一些PEP提案(五):注解的延迟求值

类型注解从诞生开始就保持一个基本的原则,也就是加与不加不应该影响Python代码的运行,但是很多提案都在给这个机制擦屁股。

PEP 563:字符串化(Postponed Evaluation of Annotations)

我们看一个例子:

python 复制代码
# ❌ 报错:NameError
class TreeNode:
    def __init__(self, left: TreeNode):  # 定义时 TreeNode 还没创建完成
        pass

如果是上面这种情况,其实一般的解决办法就是直接去掉类型注解了。但如果我就是不想去掉,那就得想点其他办法了。

PEP 563 的做法就是,把注解变成字符串存起来:

python 复制代码
from __future__ import annotations

def func(x: int, y: list[str]):
    pass

print(func.__annotations__)
# 输出:{'x': 'int', 'y': 'list[str]'}  ← 全是字符串!

编译器在编译代码时,直接将注解表达式转换为字符串字面量,存储在 __annotations__ 字典中。字符串不需要名字存在,自然解决了 TreeNode 问题。

但是,许多库(Pydantic, FastAPI, SQLAlchemy)依赖 __annotations__ 获取真实的类型对象来做验证或 ORM 映射,现在只能拿到字符串了。这意味着需要专门为这个PEP做适配。

PEP 649:描述符延迟求值(Deferred Evaluation Using Descriptors)

Python 3.13+ 默认启用,是 PEP 563 的继任者和替代者。

PEP 649 不存储字符串,而是存储编译后的代码对象(Code Objects)。

它引入了一个新的 __annotations__ 映射对象,这个对象是一个描述符(Descriptor)。当你访问注解时,它会自动执行存储的代码块,求值得到真实的类型对象,并缓存结果。

python 复制代码
# Python 3.13+ (默认行为,无需 import)
def func(x: int, y: list[str]):
    pass

print(func.__annotations__)
# 输出:{'x': <class 'int'>, 'y': list[str]}  ← 看起来是真实对象!
# 实际上底层是延迟求值的,但对外表现透明

(我手头并没有python3.13的环境,所以无法保证上述运行结果是正确的)

其实上述代码在早期Python版本也能正常运行,开启3.13的PEP649后,应该能确保两件事:

  1. 不再出现前向声明导致崩溃的问题
  2. 如果执行如下代码,应该会输出对应的结果:
python 复制代码
# Python 3.13+
def func(x: int): pass

print(type(func.__annotations__)) 
# 3.12 及之前:<class 'dict'>
# 3.13+: <class 'annotations'> (或类似的代理对象)
相关推荐
惜.己1 小时前
Java结合idea简单使用Playwright
java·开发语言·自动化
利威尔xu2 小时前
PostgreSQL 索引失效 4 类:函数运算让查询全表扫描拖垮性能
开发语言·数据库·postgresql·性能优化·索引优化
ShineWinsu2 小时前
对于Qt:QSpacerItem常见属性以及方法的解析
开发语言·c++·qt·面试·系统架构·客户端·qspaceritem
ShineWinsu5 小时前
对于Qt:QGripLayout常见属性、方法以及QSizePolicy的解析
开发语言·c++·qt·面试·gui·客户端·网格
艾莉丝努力练剑5 小时前
【AI大模型接入SDK】C++的SessionManager 线程安全
java·开发语言·前端·c++·人工智能·学习·安全
kyle~5 小时前
FastAPI --- 将业务能力以 API 的形式提供给外部系统
python·fastapi·前后端
aiotto资源分享6 小时前
Python 写 JSON 文件,程序中途退出会留下什么?
java·python·json·jsondecodeerror
利威尔xu6 小时前
Go Mutex 饥饿模式:正常模式等待者饿死,1ms 阈值自动切换崩溃
开发语言·后端·面试·golang·并发编程
梯度下降者7 小时前
Python信号量,条件变量,事件学习
python·条件变量·事件·信号量·线程通信
MSTcheng.7 小时前
【AI应用实战】用 FastAPI + SSE 做一个自己的 AI 聊天网页:流式输出、多轮对话与完整源码
人工智能·python·大模型·fastapi·sse·ai聊天助手