Python类中双下划线关键字参数报错？dataclass私有属性传参问题

一、类__init__中双下划线参数的关键字传参报错原因 #

这是Python的**名称修饰（Name Mangling）**机制导致的：

• 类中所有以双下划线__开头（且不以双下划线结尾）的标识符，会被Python自动重命名为_类名__标识符的形式，目的是避免子类意外覆盖父类的私有属性/方法。
• 当你在__init__中定义__a_kwarg参数时，Python在类定义阶段就把这个参数名修饰成了_Dunder__a_kwarg。调用时用位置参数传参，Python按参数顺序匹配所以没问题；但用关键字参数__a_kwarg="Hello"时，Python找不到这个参数名（实际参数名已变为_Dunder__a_kwarg），因此抛出TypeError。
• 普通函数不属于类作用域，不会触发名称修饰机制，所以同名关键字参数可正常使用。

示例代码：

class Dunder:
    def __init__(self, __a_kwarg):
        self.__a = __a_kwarg

# 位置参数正常运行
d1 = Dunder("test")
# 直接用__a_kwarg传关键字参数会报错：TypeError: __init__() got an unexpected keyword argument '__a_kwarg'
# d2 = Dunder(__a_kwarg="test")
# 必须用修饰后的参数名才能传关键字参数
d2 = Dunder(_Dunder__a_kwarg="test")

二、dataclass中实现带默认值的私有属性及消除自动生成的非私有属性 #

1. 实现带默认值的私有属性 #

dataclass默认会把定义的字段直接生成类属性，但双下划线开头的字段会触发名称修饰，导致调用异常。推荐通过普通字段中转的方式实现：

• 先定义一个不带双下划线的普通字段，设置默认值；
• 在__post_init__方法中，将该字段的值赋值给私有属性__xxx，再删除原来的普通字段。

示例代码：

from dataclasses import dataclass

@dataclass
class MyData:
    a_kwarg: str = "Hello World"  # 带默认值的普通字段

    def __post_init__(self):
        self.__a_kwarg = self.a_kwarg  # 转为私有属性
        del self.a_kwarg  # 删除自动生成的非私有属性

# 调用时可正常传关键字参数
obj = MyData(a_kwarg="Custom Value")
# 访问私有属性需用修饰后的名称
print(obj._MyData__a_kwarg)  # 输出: Custom Value
# 访问原普通字段会报错：AttributeError: 'MyData' object has no attribute 'a_kwarg'

2. 让PyCharm识别已移除的非私有属性 #

• 上述代码中del self.a_kwarg执行后，PyCharm会自动识别该属性已被删除，不会再提示其存在。
• 若仍有残留提示，可在类的注释中明确说明，或通过类型注解辅助（比如在类中添加a_kwarg: None的注解，注意不要与dataclass的字段定义冲突），但最直接的方式是确保__post_init__中的del语句正确执行，PyCharm会自动同步识别。

如果不想用普通字段中转，也可以给dataclass设置init=False，手动定义__init__方法处理私有属性，但会失去dataclass自动生成__init__、__repr__等方法的便捷性：

from dataclasses import dataclass

@dataclass(init=False)
class MyData:
    def __init__(self, a_kwarg: str = "Hello World"):
        self.__a_kwarg = a_kwarg

obj = MyData(a_kwarg="Custom Value")
print(obj._MyData__a_kwarg)

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