如何检查Python dataclass是否为冻结状态？是否需新增is_frozen方法？

一、现有检查方法 #

Python标准库的dataclasses模块目前没有提供内置的is_frozen方法，但可以通过以下方式实现检查：

1. 检查类的__frozen__属性（推荐，无副作用）

当使用@dataclass(frozen=True)装饰类时，装饰器会自动给类添加一个__frozen__类属性，值为True。我们可以直接通过这个属性判断：

from dataclasses import dataclass

def is_frozen(obj):
    return getattr(type(obj), '__frozen__', False)

@dataclass(frozen=True)
class Person:
    name: str
    age: int

person = Person('Alice', 25)
print(is_frozen(person))  # 输出: True

这个方法不会修改实例属性，完全没有副作用，是最可靠的方式。

2. 异常捕获法（不推荐，有副作用）

如你提到的，可以尝试修改属性并捕获FrozenInstanceError，但这种方法会在非冻结实例上修改属性，可能破坏原有数据：

from dataclasses import dataclass, FrozenInstanceError

@dataclass(frozen=True)
class Person:
    name: str
    age: int

person = Person('Alice', 25)
is_frozen = False
try:
    # 尝试修改属性，会触发异常如果是冻结实例
    person.name = 'check_if_frozen'
except FrozenInstanceError:
    is_frozen = True
print(is_frozen)  # 输出: True

如果必须用这种方式，可以改为尝试设置一个不存在的属性，避免修改原有数据：

try:
    object.__setattr__(person, '_temp_check', None)
except FrozenInstanceError:
    is_frozen = True
else:
    del person._temp_check
    is_frozen = False

但这种方式仍然比直接检查__frozen__属性繁琐。

二、新增is_frozen内置方法的价值 #

在dataclasses模块中新增is_frozen方法是有实际价值的：

• API一致性：dataclasses模块已有is_dataclass等工具方法，新增is_frozen可以完善工具链，让用户无需自己实现判断逻辑。
• 避免依赖内部属性：虽然__frozen__是当前实现的一部分，但它并非官方文档明确承诺的公共API，未来存在变更风险。内置方法可以屏蔽底层实现细节。
• 代码可读性：直接调用is_frozen(person)比手动检查__frozen__属性更直观，降低代码理解成本。

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