Python私有方法靠双下划线触发名称修饰(如__method→_Class__method),旨在防止子类意外覆盖,而非强制访问控制;单下划线仅表约定,双下划线才修饰,且不修饰特殊方法(如__init__)或结尾含双下划线者。

Python私有方法不是真的私有,而是靠命名约定和名称修饰
Python没有真正意义上的私有方法,__method_name 这种双下划线开头的写法会触发名称修饰(name mangling),把方法名改写成 _ClassName__method_name。这不为隐藏,只为避免子类**意外覆盖**——它不是访问控制机制,而是一种“别乱碰”的信号。
什么时候该用双下划线 __ 而不是单下划线 _
单下划线 _method 是约定俗成的“内部使用”,解释器不做处理;双下划线 __method 才会触发名称修饰。只有当你明确希望子类无法通过同名方式无意中覆盖父类逻辑时,才用双下划线。
- 子类重写了
__init__,但忘了调用super().__init__()→ 父类的__setup可能根本没执行 - 父类有个
__validate,子类也写了个__validate→ 如果没双下划线,子类直接覆盖;加了双下划线后,父类实际调的是_Parent__validate,子类默认调的是_Child__validate,互不影响 - 调试时用
dir(obj)查看属性,能看到类似_Parent__helper的名字,这就是名称修饰生效的证据
双下划线名称修饰的边界和陷阱
名称修饰只对类定义体内、以 __ 开头且**不以 __ 结尾**的标识符生效。它不处理字符串里的名字、动态拼接的属性名,也不影响模块级函数或变量。
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
-
__method__(前后都双下)不会被修饰,这是特殊方法,比如__init__、__str__ -
__value = 42在类体里会被修饰;但obj.__value = 99是给实例新增一个普通属性,跟修饰后的_ClassName__value完全无关 - 子类想显式调用父类的双下划线方法,得用修饰后的名字:
self._Parent__helper(),而不是self.__helper() - 用
getattr(obj, '_Parent__helper')可以绕过语法限制调用,说明它从来就不是“不可访问”
实际建议:优先用单下划线,双下划线仅用于强隔离场景
绝大多数“内部方法”用 _helper 就够了。双下划线容易让调试变麻烦,也让继承关系更难理清。只有当父类逻辑极度敏感、且你预见到子类极可能起同名方法(比如框架基类中的钩子),才启用 __。
- 避免在抽象基类(ABC)里对钩子方法用双下划线——子类本该实现它,修饰后反而难以对接
- 如果方法只是不想被外部直接调用,但子类需要复用,就别用双下划线,改用文档说明 + 单下划线
- Pydantic、Django 等主流库极少在公开接口里用双下划线方法,它们靠设计约束而非名称修饰来保障正确性
名称修饰是 Python 给开发者的一个“隔离缓冲带”,不是铁壁。真正关键的,是理解哪个方法的语义必须隔绝继承干扰——那才是决定是否加双下划线的分水岭。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










