Python无真正私有属性,单下划线\_表示受保护(非强制)、双下划线\_\_触发名称改写防冲突,真正封装需用@property配合私有属性及方法。

Python 中没有真正意义上的私有属性,但通过命名约定和语言机制可以实现封装效果。关键在于理解 单下划线 _、双下划线 __ 的作用差异,以及如何合理使用它们来表达设计意图。
单下划线 _:提示“受保护”,非强制限制
以单下划线开头的属性(如 _name)是 Python 社区公认的“内部使用”约定。它不会阻止外部访问,只是向其他开发者发出信号:这个属性不建议直接调用或修改。
- 解释器不做任何访问限制,obj._name 依然可读可写
- 在 from module import * 时,这类名称默认不会被导入
- 适用于“子类可能需要继承/重写”的内部状态,比如缓存字段、临时计算值
双下划线 __:触发名称改写(Name Mangling)
以双下划线开头(且不以双下划线结尾)的属性(如 __value),Python 会在编译时自动将其重命名为 _ClassName__value,从而避免子类意外覆盖。
- 不是为了绝对隐藏,而是防止命名冲突,尤其在继承链中
- 仍可通过改写后的名字访问(如 obj._MyClass__value),所以不适用于安全敏感场景
- 若属性名以双下划线结尾(如 __init__),则不触发改写,属于特殊方法
真正封装靠 property 和私有方法配合
要实现可控的读写逻辑(如校验、懒加载、只读),应结合 @property 和私有属性(通常用单下划线):
立即学习“Python免费学习笔记(深入)”;
- 把实际数据存为 _age,暴露 age 属性控制访问
- 在 @age.setter 中加入类型检查或范围限制
- 私有方法(如 _validate_email())配合 property 使用,增强内聚性
封装策略选择建议
不要为了“私有”而私有。选择依据是设计意图而非技术手段:
- 仅供当前类内部使用、无继承需求 → 可用双下划线,但更推荐单下划线 + 清晰注释
- 需子类扩展或框架回调 → 用单下划线,保持可覆盖性
- 需要对外提供受控接口 → 用 property 封装单下划线属性
- 敏感数据或需权限控制 → Python 不是合适载体,应交由系统层或服务层处理










