Python 私有属性真的私有吗

python私有属性仅是命名约定，双下划线触发名称改写而非访问控制；单下划线为约定提示，特殊方法不参与改写；推荐用@Property配合单下划线实现安全封装。

Python 私有属性只是命名约定，不是访问控制

Python 没有真正的私有属性机制，__name 这种双下划线前缀触发的是名称改写（name mangling），不是权限封锁。解释器不会阻止你访问，只是让直接访问变麻烦。

常见错误现象：AttributeError 报错时以为“被禁止访问”，其实只是名字变了；或者在子类里误以为 self.__x 和父类的 self.__x 是同一个变量，结果发现是两个独立属性。

• 双下划线前缀（如 __value）会被自动重命名为 _ClassName__value，仅在定义该属性的类作用域内生效
• 单下划线前缀（如 _value）纯属约定，表示“请勿直接使用”，解释器完全不管
• 以 __ 开头且以 __ 结尾的（如 __init__）是特殊方法，不参与名称改写

怎么安全地“隐藏”属性：用 @property + 单下划线

真想控制读写逻辑，别依赖双下划线，用 @property 配合单下划线私有字段更清晰、更可控。

使用场景：需要校验赋值、延迟计算、兼容旧接口、或未来可能加逻辑的字段。

立即学习“Python免费学习笔记（深入）”；

示例：

class BankAccount:     def __init__(self, balance):         self._balance = balance  # 真实存储用单下划线 <pre class="brush:php;toolbar:false;">@property def balance(self):     return self._balance  @balance.setter def balance(self, value):     if value < 0:         raise ValueError("Balance cannot be negative")     self._balance = value

• 外部调用 acc.balance = -100 会触发 setter 校验，而不是静默失败
• 子类可以自由覆盖 balance 属性，无需处理名称改写带来的歧义
• 比 __balance 更易调试——堆栈里看到的是 balance，不是 _BankAccount__balance

双下划线在继承中容易踩的坑

名称改写是按**当前类名**做的，不是运行时类型。子类定义同名 __field，会生成不同名字，彼此隔离——这不是封装，是意外隔离。

常见错误现象：父类方法里读 self.__data，子类重写了 __data，但父类读到的还是自己的那份，导致逻辑错乱。

• 父类 A 中的 self.__x → 实际存为 self._A__x
• 子类 B(A) 中的 self.__x → 实际存为 self._B__x，和父类完全无关
• 如果想让子类“真正覆盖”某个内部字段，必须用单下划线（_x）或显式调用父类名称（self._A__x，不推荐）

什么时候才该用双下划线？

只有一种情况值得用：__name 是为了防止子类意外覆盖父类的内部实现细节，且你明确接受它带来的调试难度和继承限制。

典型场景：Mixin 类里定义一个极小概率冲突的钩子名，比如 __on_init_complete，确保即使子类也定义了 __on_init_complete，也不会互相干扰。

• 不要用它来“保护数据”或“防止误用”——那不是它的设计目标
• ide 和静态检查工具（如 mypy）对双下划线字段的支持较弱，补全和类型提示可能失效
• 序列化（pickle）、调试（vars()、dir()）时，得手动处理改写后的名字，容易漏

双下划线的名称改写发生在编译期，但改写规则依赖类定义时的字面类名，动态创建类或使用字符串拼接类名时行为可能出人意料。