如何使用dataclasses实现仅关键字（keyword-only）字段？

嘿，这个问题问得好！在dataclasses里实现像普通类那样的仅关键字参数，确实不能直接照搬函数定义里的*分隔写法——dataclass的字段声明语法不支持这个语法。不过有几种非常贴合需求的实现方式，我给你拆解一下：

方案1：Python 3.10+ 最优解（声明式实现） #

从Python 3.10开始，dataclasses.field()新增了kw_only=True参数，直接给需要设为仅关键字的字段加上这个参数就行，完美贴合你的声明式需求：

from dataclasses import dataclass, field

@dataclass
class S3Obj:
    bucket: str
    key: str
    storage_class: str = field(default='Standard', kw_only=True)

效果验证 #

• 合法调用（位置+关键字参数）：

  obj1 = S3Obj('my-bucket', 'my-key')  # 用默认的storage_class
  obj2 = S3Obj('my-bucket', 'my-key', storage_class='Glacier')  # 指定关键字参数
  

• 非法调用（直接传位置参数会报错）：

  obj3 = S3Obj('my-bucket', 'my-key', 'Glacier')  # TypeError: S3Obj.__init__() takes 3 positional arguments but 4 were given
  

方案2：兼容Python 3.9及以下版本 #

如果你的环境还没升级到3.10，可以手动覆盖__init__方法，既保留dataclass的其他特性（比如自动生成__repr__、__eq__等），又能实现仅关键字参数的签名：

from dataclasses import dataclass

@dataclass
class S3Obj:
    bucket: str
    key: str
    storage_class: str = 'Standard'

    # 手动定义符合需求的__init__签名
    def __init__(self, bucket: str, key: str, *, storage_class: str = 'Standard'):
        self.bucket = bucket
        self.key = key
        self.storage_class = storage_class

这个方案的效果和方案1完全一致，只是需要手动写__init__，但兼容性更好。

为什么原来的写法报错？ #

dataclass的字段声明是基于类属性的语法，它会把这些属性解析为生成__init__的参数，但不支持直接在字段列表里写*——这个*是函数定义专用的分隔符，不属于类属性的合法语法，所以会触发语法错误。

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