Python私有方法命名是约定而非访问控制：单下划线提示勿调用，双下划线触发名称改写但仍可访问；同类中应通过self.__method()调用，由解释器自动转换；静态/类方法不可直接调用实例私有方法；测试应聚焦公有接口行为而非私有实现。
私有方法命名不是访问控制，而是约定
Python 没有真正的私有方法，_method（单下划线）只是“请勿直接调用”的提示，__method（双下划线）会触发名称改写（name mangling），但依然能被访问。真正影响调用方式的，是这个机制本身——它不阻止调用，只增加直接调用的难度和意图干扰。
所以“优雅调用”的核心不是绕过限制，而是尊重封装意图：如果一个方法被设计为私有，它大概率不该被同类其他方法“随意”调用，除非逻辑上确属内部实现细节。
同类中调用 __private_method 必须用改写后名称或 self
双下划线方法在类定义时会被自动重命名为 _ClassName__method。在同一个类内部，推荐始终通过 self.__private_method() 调用——Python 解释器会在编译期自动将其转换为改写后的形式，无需手动拼接。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- ✅ 正确：
self.__parse_config()（即使类名是ConfigLoader，也别写成self._ConfigLoader__parse_config()） - ❌ 错误：
self._ConfigLoader__parse_config()—— 硬编码类名破坏继承兼容性，子类重写该方法时可能失效 - ⚠️ 注意：
__触发改写的前提是方法定义在类作用域内，且名称以双下划线开头、非双下划线结尾（如__init__不改写）
避免在 @staticmethod 或 @classmethod 中调用实例级私有方法
静态方法和类方法没有 self 或 cls 实例上下文，无法直接访问实例属性或实例私有方法。若你发现需要从 @staticmethod 里调用 self.__helper()，说明这个方法其实不该是静态的。
立即学习“Python免费学习笔记（深入）”；
- 如果逻辑依赖实例状态 → 改为普通实例方法
- 如果逻辑完全无状态但又需复用私有逻辑 → 把私有逻辑抽成独立函数（放在模块顶层或
utils子模块），而非塞进类里伪装成私有方法 - 如果坚持留在类内且需被类方法调用 → 考虑改为
@classmethod并接受cls，但此时调用的必须是真正属于类层级的私有方法（即不依赖self），否则仍会出错
测试私有方法时不要强行调用，优先测行为而非实现
单元测试中试图用 obj._MyClass__do_work() 直接测私有方法，是典型的“测试过深”。私有方法随时可能被重构、拆分或删除，而它的行为应已覆盖在公有方法的测试中。
- ✅ 好做法：通过公有接口触发路径，断言最终输出或状态变化
- ❌ 坏信号：写一堆测试专门校验
__validate_input的返回值——这说明公有方法职责过重，或验证逻辑本该更开放（比如做成可注入的策略） - ⚠️ 例外：极少数场景（如复杂算法中间步骤需隔离验证），可临时用改写名调用，但务必加注释说明原因，并在重构时同步更新测试
