如何对Python中带有双下划线的类方法进行单元测试

问题原因 #

无法直接访问__some_method是Python的**名称修饰（Name Mangling）**机制的正常表现：所有以双下划线__开头、且不以双下划线结尾的类成员（属性、方法），都会被解释器自动重命名为_<类名>__<原成员名>的格式，目的是避免子类意外覆盖父类的私有成员。

可用解决方法 #

方法1：直接使用修饰后的名称调用（最便捷） #

只要知道定义该方法的类名，直接用重命名后的规则访问即可。示例如下：

# 假设你的原类定义如下
class MyDemoClass:
    @staticmethod
    def __some_method():
        # 原有逻辑
        return "expected result"

# 单元测试中调用方式
def test_private_static_method():
    # 格式为：类名._类名__私有方法名
    result = MyDemoClass._MyDemoClass__some_method()
    assert result == "expected result"

方法2：新增测试专用访问入口 #

如果不想依赖Python内部的名称修饰规则，可以在类中额外新增一个仅供测试使用的公开入口，生产环境无需调用该入口即可：

class MyDemoClass:
    @staticmethod
    def __some_method():
        return "expected result"
    
    # 测试专用入口，仅单元测试时调用
    @staticmethod
    def _access_private_for_test():
        return MyDemoClass.__some_method()

补充建议 #

通常单元测试优先通过类的公开接口调用路径覆盖私有方法的逻辑，只有当私有方法逻辑复杂度很高、单独测试的投入产出比更高时，再选择上述直接访问私有方法的方案。

内容的提问来源于stack exchange，提问作者user9186277