@dataclass加__slots__需手动声明字段名,slots=True仅控制是否生成__slots__但不自动填充;必须显式定义__slots__元组,字段顺序与定义一致,继承时需手动合并父类__slots__。

dataclass加__slots__需要手动声明,Python不自动补全
Python 3.10 的 @dataclass 默认不会生成 __slots__,哪怕你写了 slots=True 参数——它只控制类体是否声明 __slots__,但字段名必须显式列出,否则会报 TypeError: non-default field ' 或运行时访问失败。
常见错误是以为加了 slots=True 就万事大吉,结果内存没省、还多出一个空 __dict__。
- 必须把所有字段名(不含
init=False或classvar)写进__slots__元组 - 字段顺序要和定义顺序一致,否则
__slots__不生效(CPython 实现细节) - 带默认值的字段不能放在无默认值字段之后,否则 dataclass 初始化失败
正确写法:用slots=True + 显式__slots__元组
最稳妥的方式是让 @dataclass(slots=True) 自动生成 __slots__,但前提是所有字段都满足 dataclass 的 slot 兼容规则——即不能有 __dict__ 依赖、不能动态赋值未声明字段、且不能继承自含 __dict__ 的父类。
实际中更可控的做法是手动定义:
@dataclass
class Point:
x: float
y: float
label: str = "origin"
<pre class="brush:php;toolbar:false;">__slots__ = ("x", "y", "label")
注意:__slots__ 必须是类属性(不是实例属性),且类型提示不影响 slots 内容;如果字段用了 field(default_factory=list),它仍需列入 __slots__。
继承场景下__slots__不自动合并,必须显式叠加
子类加 @dataclass(slots=True) 不会合并父类的 __slots__,Python 会直接忽略父类 slots,导致父字段可被动态设置、失去内存优势。
解决方式只有两种:
- 父类也手动定义
__slots__,子类用__slots__ = (*Parent.__slots__, "new_field") - 避免继承,改用组合(更推荐,尤其对内存敏感场景)
例如:
@dataclass
class Shape:
color: str
__slots__ = ("color",)
<p>@dataclass
class Circle(Shape):
radius: float
<strong>slots</strong> = (*Shape.<strong>slots</strong>, "radius") # 必须展开,不能写 ("color", "radius")
</p>
验证是否真节省了内存:别只看__slots__有没有
加了 __slots__ 不等于内存一定下降——如果类里有弱引用、描述符、或用了 __weakref__,CPython 仍会分配 __dict__。还要检查实例是否真的没 __dict__:
p = Point(1.0, 2.0)
print(hasattr(p, "__dict__")) # 应为 False
print(p.__slots__) # 应返回 ('x', 'y', 'label')
另外,sys.getsizeof(p) 在小对象上差异不明显,建议用 pympler.asizeof.asizeof(p) 测整体内存占用;大量实例(如十万级)才看得出收益。
真正容易被忽略的是:一旦启用 __slots__,就不能再给实例动态加新属性,连 __annotations__ 修改都会失败——这不是 bug,是设计约束。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











