17370845950

Python无严格私有成员，单下划线（_name）表受保护约定，双下划线（__name）触发病名改写（_ClassName__name）防子类覆盖，双下划线前后（__name__）为魔法方法；真封装需@property等机制。

Python 中没有严格意义上的私有成员，但通过命名约定和语言机制实现了封装效果。理解这一点是掌握 Python 面向对象设计的关键。

下划线前缀的含义：单下划线与双下划线

Python 用下划线前缀表达访问意图，而非强制限制：

• _name：单下划线开头，属“受保护”（protected）约定，提示开发者“建议外部不要直接访问”，但语法上完全可读可写；IDE 和文档工具会将其标记为内部使用。
• __name：双下划线开头（且不以双下划线结尾），触发名称改写（name mangling）——Python 自动将其重命名为 _ClassName__name，目的是避免子类意外覆盖父类的同名属性或方法。
• __name__：双下划线开头和结尾，属于特殊方法（如 __init__、__str__），是 Python 的魔法方法，不参与私有化处理。

名称改写（Name Mangling）的实际表现

双下划线触发的改写仅发生在类定义体中，且只对标识符本身生效：

• 在类内部，直接写 self.__value，Python 会自动转为 self._MyClass__value；
• 子类中定义 __value，会被改写为 _SubClass__value，与父类互不干扰；
• 改写不递归：若属性是字典，其中键名为 "__key"，不会被改写；只有类体中显式声明的变量/方法名才受影响。

如何真正实现“不可变”或“受控访问”

靠下划线无法阻止访问，真正封装需配合其他机制：

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

• 用 @property 定义只读或带校验的属性，例如：
  

  @property
  def age(self): return self._age
  
  @age.setter
  def age(self, v):
    if v < 0: raise ValueError("Age can't be negative")
    self._age = v

• 在 __init__ 或关键方法中做输入检查，把逻辑控制权留在类内；
• 文档字符串（docstring）和类型提示（如 _id: int）明确传达设计意图，辅助团队协作。

常见误区与实践建议

避免把双下划线当作“安全锁”：

• 不要依赖 __name 防止用户访问——它只是防手误，不是防恶意；
• 除非有明确的子类冲突风险，否则优先用单下划线 _helper 表达内部用途；
• 测试时若需访问双下划线属性（如单元测试验证内部状态），可用改写后的名字 obj._ClassName__attr，但应视为临时手段；
• 对外暴露的 API 应稳定、语义清晰，私有约定是为未来重构留余地，不是隐藏复杂性。