如何合理为Python变量添加元数据以支持热重载？

方案1：基于装饰器的属性标记 #

通过给@property添加自定义装饰器，标记需要热重载的属性，不改变外部使用方式：

def hotsave(func):
    # 给函数添加标记，供热重载器识别
    func._is_hotsave = True
    return func

class Player:
    def __init__(self):
        self._pos_x = 0
        self._pos_y = 0

    @hotsave
    @property
    def pos_x(self):
        return self._pos_x

    @pos_x.setter
    def pos_x(self, value):
        self._pos_x = value

    # 这个属性不参与热重载
    @property
    def pos_y(self):
        return self._pos_y

• 优点：外部调用完全正常（player.pos_x），类型提示、代码补全不受影响；标记集中在属性定义处，不需要修改所有引用。
• 缺点：需要把普通属性改成@property形式，增加少量代码量。

方案2：利用Annotated类型注解标记 #

Python 3.9+支持的Annotated可以给变量添加元数据，用它标记需要热重载的变量：

from typing import Annotated

# 定义一个空对象作为标记
HOTSAVE = object()

class Player:
    def __init__(self):
        # 标记pos_x需要热重载
        self.pos_x: Annotated[int, HOTSAVE] = 10
        # 这个变量不标记
        self.radius: int = 5

• 优点：完全不改变变量的使用和行为，类型提示兼容；标记直观，只需要在注解处添加。
• 缺点：依赖Python 3.9+；热重载器需要解析变量的注解信息，实现稍复杂。

方案3：类级别的变量清单 #

在类中定义一个特殊的类属性，列出所有需要热重载的实例变量名：

class Player:
    # 类属性：声明需要热重载的实例变量
    _HOTSAVE_VARS = {"pos_x", "radius"}

    def __init__(self):
        self.pos_x = 10
        self.radius = 5
        self.temp_score = 0  # 不在清单中，不参与热重载

• 优点：不需要修改变量定义，使用完全正常；所有标记集中在一处，便于管理。
• 缺点：如果变量名修改，需要同步更新清单，容易出现遗漏；热重载器需要读取类的这个特殊属性。

方案4：透明描述符包装 #

改进之前的包装方案，用描述符实现对原对象的透明代理，不影响变量行为：

from typing import Generic, TypeVar

T = TypeVar('T')

class HotSave(Generic[T]):
    def __set_name__(self, owner, name):
        self.storage_name = f"_hotsave_{name}"

    def __get__(self, instance, owner) -> T:
        if instance is None:
            return self
        return getattr(instance, self.storage_name)

    def __set__(self, instance, value: T):
        setattr(instance, self.storage_name, value)

class Player:
    # 直接用HotSave标记属性
    pos_x: HotSave[int] = HotSave()
    radius: HotSave[float] = HotSave()

    def __init__(self):
        self.pos_x = 10
        self.radius = 5.0

• 优点：外部使用和普通属性完全一致；通过泛型支持类型提示和代码补全；热重载器可以直接识别HotSave类型的描述符。
• 缺点：需要定义泛型描述符类；类中声明属性时多一行代码。

内容的提问来源于stack exchange，提问作者RedEgs