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 应稳定、语义清晰，私有约定是为未来重构留余地，不是隐藏复杂性。
