Python中private字段不能仅靠命名约定代替，因下划线前缀无强制访问控制；需用__name+property组合实现真正封装与校验。
private 字段为什么不能靠命名约定来代替
用 _name 或 __name 这类下划线前缀，不是真正的访问控制，只是提示“别碰”，Python 解释器完全不拦着。你在外部仍能直接读写 obj._value，甚至通过 obj._ClassName__secret 访问双下划线名——这叫名称改写（name mangling），不是封装。
真正需要隐藏时，必须配合 property + private 字段组合，让读写走可控路径：
class BankAccount:
def __init__(self, initial):
self.__balance = initial # 真正私有，外部无法直接访问
<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 # 写入带校验
-
__balance在实例上实际变成_BankAccount__balance，反射或调试时可见，但普通调用不会误触 - 直接
acc.__balance = 100会静默创建新字段，不修改原值——这是最常踩的坑：你以为改了，其实没动 - 如果只读，就别定义 setter；如果连读都不该暴露，干脆不加
@property，只留内部方法操作
private 方法该不该加类型提示
应该加，且要用 Callable 或具体签名，否则静态检查工具（如 mypy）无法识别调用合法性。private 方法不是“不存在”，而是“不承诺公开契约”。
- 用
def _validate_input(self, data: str) -> bool:，而非def _validate_input(self, data) -> bool: - 调用时仍需确保只在类内使用：
self._validate_input(x)合法，inst._validate_input(x)虽然能运行，但 mypy 会报error: Access to a protected member _validate_input - IDE（如 PyCharm）对
_开头方法默认不自动补全，但对__开头的更彻底屏蔽——后者更适合核心校验逻辑
继承场景下 private 字段如何避免冲突
子类若也定义 __field，它和父类的 __field 是两个独立变量，因为名称改写基于类名。这既是保护，也是陷阱。
class Parent:
def __init__(self):
self.__data = "parent"
<p>class Child(Parent):
def <strong>init</strong>(self):
super().<strong>init</strong>()
self.<strong>data = "child" # 实际是 _Child__data，和 _Parent</strong>data 无关
- 父类方法里访问
self.__data永远拿到_Parent__data，哪怕子类覆盖了同名 private 字段 - 如果子类需要扩展父类状态，应显式调用父类初始化，并用受控方式（如
super()._setup_state()）而非直接操作 private 名 - 跨层级共享状态，优先用
_single_underscore命名 + 文档说明“子类可覆写”，比硬用__double更灵活
什么时候该放弃 private，改用模块级作用域
如果某个状态只被本模块内几个类共用，且无需实例隔离，private 字段反而增加复杂度。这时把变量放在模块顶层、用 _helper_cache = {} 管理更合适。
- 例如缓存解析结果：
_parser_cache: Dict[str, AST] = {}，所有类都可读写，但不对外暴露 - 模块级 private 变量不会被
from module import *导入，符合封装意图 - 注意线程安全：模块变量是全局的，多线程写入需加锁，而实例
__field天然是隔离的
private 的本质不是“不让看”，是“不让你依赖它的存在形式”。一旦发现为了绕过 private 不得不 inspect 或 monkey patch，说明设计边界已经模糊了——该重新划分职责，而不是加更多下划线。
