Python私有属性仅是命名约定，双下划线触发名称改写而非访问控制；单下划线为约定提示，特殊方法不参与改写；推荐用@property配合单下划线实现安全封装。
Python 私有属性只是命名约定，不是访问控制
Python 没有真正的私有属性机制，__name 这种双下划线前缀触发的是名称改写（name mangling），不是权限封锁。解释器不会阻止你访问，只是让直接访问变麻烦。
常见错误现象：AttributeError 报错时以为“被禁止访问”，其实只是名字变了；或者在子类里误以为 self.__x 和父类的 self.__x 是同一个变量，结果发现是两个独立属性。
- 双下划线前缀（如
__value）会被自动重命名为_ClassName__value，仅在定义该属性的类作用域内生效 - 单下划线前缀（如
_value）纯属约定，表示“请勿直接使用”，解释器完全不管 - 以
__开头且以__结尾的（如__init__）是特殊方法，不参与名称改写
怎么安全地“隐藏”属性：用 @property + 单下划线
真想控制读写逻辑，别依赖双下划线，用 @property 配合单下划线私有字段更清晰、更可控。
使用场景：需要校验赋值、延迟计算、兼容旧接口、或未来可能加逻辑的字段。
立即学习“Python免费学习笔记（深入）”；
示例：
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
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()）时，得手动处理改写后的名字，容易漏
双下划线的名称改写发生在编译期，但改写规则依赖类定义时的字面类名，动态创建类或使用字符串拼接类名时行为可能出人意料。
