Python中支持可变、类型提示的结构体方案选型咨询

对于你需求的可变、带类型提示、支持默认值与参数校验的结构体，dataclasses.dataclass是最匹配的解决方案，完全满足所有要求：

基础实现代码 #

from dataclasses import dataclass
from typing import Optional

@dataclass
class MyStruct:
    # 必填参数：无默认值
    prop1: str
    prop2: str
    # 可选参数：带默认值
    prop3: Optional[str] = "prop3"
    prop4: Optional[str] = "prop4"
    # 可继续添加更多属性...

对应需求的验证 #

• 传入必填参数实例化：正常执行

  struct = MyStruct(prop1="prop1", prop2="prop2")
  

• 参数顺序无关：支持关键字参数，顺序可随意调整

  struct = MyStruct(prop2="prop2", prop1="prop1")
  

• 为可选属性传值：直接覆盖默认值

  struct = MyStruct(prop1="prop1", prop2="prop2", prop3="hello")
  

• 点语法访问属性：直接通过.访问

  print(struct.prop3)  # 输出 "prop3" 或自定义值
  

• 修改属性值：默认生成的实例是可变的，直接赋值即可

  struct.prop2 = "hello!"
  

• 禁止缺少必填参数实例化：未传入prop1/prop2时会抛出TypeError，自动校验必填项

  struct = MyStruct()  # 报错：缺少必填参数
  

为什么这是最佳选择 #

1. 减少冗余代码：自动生成__init__方法，无需手动编写20-30个参数的构造器，避免重复劳动
2. 完善的类型提示：编辑器（如VS Code、PyCharm）能自动补全属性和构造器参数，完全符合类型检查需求
3. 灵活的可变性：默认生成可变实例，满足属性修改的需求；若后续需要不可变，只需添加@dataclass(frozen=True)即可
4. 原生支持默认值与校验：必填参数只需不设置默认值，自动触发实例化时的参数校验，无需额外逻辑

其他方案的不足 #

• NamedTuple：本质是不可变元组，无法修改属性值，不符合核心需求
• TypedDict：仅为字典提供类型提示，需通过[]访问属性，不是面向对象的实例结构，且无原生的实例化参数校验
• 普通类：需手动编写冗长的__init__方法，参数越多越容易出错，维护成本高

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