如何在Python类中声明允许的实例变量并支持动态赋值？

我需要用Python类对象存储多组模拟数据，每个实例属性完全一致，但要在程序运行过程中分步动态赋值，而不是创建实例时一次性传完所有参数。

当前有两种不太满意的实现方式：

1. 带大量参数的__init__构造方法：必须等模拟结束、所有数据都生成后才能创建对象，还要额外用临时变量存数据，参数列表太长太繁琐：

simulations = []

class output_data_class:
    def __init__(self, variable1, variable2):
        self.variable1 = variable1
        self.variable2 = variable2

# 模拟过程生成数据
variable1 = 'something'  # 不想用这种临时变量
variable2 = 123          # 不想用这种临时变量

new_simulation = output_data_class(variable1, variable2)
simulations.append(new_simulation)

2. 空类实现：虽然能分步赋值，但属于不良实践——无法明确规定实例该有哪些属性，还容易因为拼写错误创建多余属性（比如new_simulation.variabel2 = 123）：

simulations = []

class output_data_class:
    pass

new_simulation = output_data_class()

# 模拟第一步生成variable1
new_simulation.variable1 = 'something'

# 模拟第二步生成variable2
new_simulation.variable2 = 123 

simulations.append(new_simulation)

需求总结 #

• 类定义中明确声明允许的实例属性（最好带类型提示）
• 属性是实例独立变量，不是类变量
• 无需在__init__中一次性赋值所有属性

方案1：标准库dataclasses（推荐） #

Python 3.7+自带的dataclasses可以完美平衡类型安全和分步赋值的需求：

from dataclasses import dataclass
from typing import Optional

simulations = []

@dataclass
class OutputData:
    # 声明属性及类型，用Optional标记允许初始为None
    variable1: Optional[str] = None
    variable2: Optional[int] = None

    def __setattr__(self, name, value):
        # 限制只能设置预定义属性，防止拼写错误
        if name not in self.__annotations__:
            raise AttributeError(f"OutputData实例不允许设置属性'{name}'")
        super().__setattr__(name, value)

# 创建实例，初始属性为None
new_simulation = OutputData()

# 模拟过程分步赋值
new_simulation.variable1 = 'something'
# 中间执行其他模拟逻辑
new_simulation.variable2 = 123

simulations.append(new_simulation)

• __annotations__会自动读取类中声明的属性，通过__setattr__拦截赋值操作，非法属性直接报错
• 所有属性都是实例独立的，不会和类变量混淆

方案2：自定义类+__slots__（无依赖轻量方案） #

如果不想用dataclasses，可以用__slots__直接限制实例允许的属性，同时添加类型提示：

from typing import Optional

simulations = []

class OutputData:
    # 明确指定允许的实例属性
    __slots__ = ('variable1', 'variable2')
    # 类型提示
    variable1: Optional[str]
    variable2: Optional[int]

    def __init__(self):
        # 初始化属性为None，避免后续访问未赋值属性报错
        self.variable1 = None
        self.variable2 = None

# 使用方式
new_simulation = OutputData()
new_simulation.variable1 = 'something'
new_simulation.variable2 = 123
simulations.append(new_simulation)

• __slots__会直接禁止实例创建未声明的属性，拼写错误会立刻抛出AttributeError
• 相比空类，内存占用更低，适合存储大量模拟数据

方案3：第三方库attrs（灵活增强方案） #

如果项目允许引入第三方库，attrs比dataclasses更灵活，支持更多自定义配置：

import attr

simulations = []

@attr.define(slots=True, auto_attribs=True)
class OutputData:
    variable1: str = attr.ib(default=None)
    variable2: int = attr.ib(default=None)

    def __setattr__(self, name, value):
        # 检查属性是否在预定义字段中
        if name not in attr.fields_dict(self.__class__):
            raise AttributeError(f"OutputData实例不允许设置属性'{name}'")
        super().__setattr__(name, value)

# 使用方式与前两种一致
new_simulation = OutputData()
new_simulation.variable1 = 'something'
new_simulation.variable2 = 123
simulations.append(new_simulation)

• slots=True开启内存优化，auto_attribs=True自动生成属性初始化逻辑
• 支持更多验证、转换规则，适合复杂的模拟数据场景

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