Python 3.x中从静态方法调用私有方法的正确方式与最佳实践

先看你给出的代码问题：原代码里有两处明显错误导致NameError：

1. 私有实例方法__private_method缺少第一个必选参数self——它是实例方法，必须接收实例作为第一个参数；
2. Python会对以__开头的私有成员做名称修饰，把__private_method转换成_Class_A__private_method，静态方法内部直接写__private_method会被当成未定义的全局名称。

下面是几种可行的解决方式，以及对应的最佳实践：

一、直接调用名称修饰后的方法（不推荐，仅作原理说明） #

既然Python自动把私有方法名改成了_Class_A__private_method，静态方法里可以直接用这个修改后的名字调用，但要注意实例方法必须传入实例：

class Class_A:
    def __init__(self, some_attribute):
        self.some_attr = some_attribute

    def __private_method(self, arg_a):  # 补充self参数
        print(arg_a)  # 修正原代码的arg变量名错误
    
    @staticmethod
    def some_static_method(arg_a):
        # 若需要实例属性，得先创建实例或传入实例
        temp_instance = Class_A("temp")
        temp_instance._Class_A__private_method(arg_a)

这种写法完全依赖Python的底层名称修饰规则，一旦类名修改，所有调用处都要同步修改，维护性极差，不推荐使用。

二、将私有方法改为类方法（推荐，无实例属性依赖场景） #

如果私有方法不需要访问实例的属性，只是处理类相关逻辑，把它改成类方法，静态方法就能通过类调用修饰后的方法：

class Class_A:
    def __init__(self, some_attribute):
        self.some_attr = some_attribute

    @classmethod
    def __private_method(cls, arg_a):  # 改成类方法，接收cls参数
        print(arg_a)
    
    @staticmethod
    def some_static_method(arg_a):
        Class_A._Class_A__private_method(arg_a)

三、静态方法接收实例参数（推荐，需实例属性场景） #

如果私有方法必须访问实例的属性，让静态方法接收一个Class_A实例作为参数，再通过实例调用修饰后的私有方法：

class Class_A:
    def __init__(self, some_attribute):
        self.some_attr = some_attribute

    def __private_method(self, arg_a):
        print(f"{self.some_attr}: {arg_a}")
    
    @staticmethod
    def some_static_method(instance, arg_a):
        instance._Class_A__private_method(arg_a)

调用示例：

my_instance = Class_A("John Doe")
Class_A.some_static_method(my_instance, "Not his real name")

最佳实践总结 #

• 优先重构代码结构：静态方法设计的初衷是不依赖实例或类的状态，而私有实例方法必须绑定实例，这种跨类型的调用本身就违背了设计逻辑。如果可以，尽量把需要的逻辑移到静态方法内部，或者把静态方法改成实例方法/类方法。
• 用受保护方法替代私有方法：如果方法需要被类内部的静态方法调用，建议把私有方法改成受保护方法（以单下划线_开头），这样不需要依赖名称修饰，代码更清晰易维护：

  class Class_A:
      def __init__(self, some_attribute):
          self.some_attr = some_attribute
  
      def _protected_method(self, arg_a):  # 单下划线表示仅供内部使用
          print(f"{self.some_attr}: {arg_a}")
      
      @staticmethod
      def some_static_method(instance, arg_a):
          instance._protected_method(arg_a)  # 直接调用，无需名称修饰
  

• 避免硬编码名称修饰后的方法名：这种写法脆弱且不直观，会增加后续维护成本。

内容的提问来源于stack exchange，提问作者Mehdi Rezzag Hebla