你清楚Python的staticmethod和classmethod在底层实现有何不同吗

本文目录导读：

1. 本质类型与描述器协议的行为
2. 参数传递的时机与方式（核心差异）
3. 对继承的影响
4. 内部存储与函数签名
5. 总结表

这是一个非常深入且有价值的问题。staticmethod 和 classmethod 在语法上很相似，但在 CPython 的底层实现上有着本质的区别，理解这些区别有助于你更准确地使用它们，并深入理解 Python 的对象模型。

核心区别在于：

• classmethod：是一个绑定描述器，它绑定的不是实例，而是类，当调用时，它会将 类本身 作为第一个参数（按惯例是 cls）隐式传递给包装的函数。
• staticmethod：是一个非数据描述器，它几乎什么都不做，只是简单地将它包装的函数原封不动地返回，不进行任何参数注入。

下面从几个关键的底层机制层面进行详细对比：

本质类型与描述器协议的行为

在 CPython 源码（Objects/funcobject.c 和 Objects/classobject.c）中，这两个东西的实现是两个不同的 C 结构体。

• staticmethod：

  • 其底层类型是 staticmethod。
  • 它实现了 非数据描述器协议 (__get__ 方法)，当通过实例或类访问时，它的 __get__ 方法会返回其内部存储的那个原始函数对象（self.__func__），不做任何修改,也不绑定到任何对象。
  • 你可以把它想象成一个透明的包装纸：无论通过 instance.static_method 还是 MyClass.static_method 访问，它都返回那个普通的、简单的函数对象本身。

• classmethod：

  • 其底层类型是 classmethod。
  • 它实现了 绑定描述器协议 (__get__ 方法)，它的 __get__ 方法会执行一个关键步骤：创建一个 绑定方法对象 (bound method object)。
  • 这个绑定方法对象是什么？它是一个新的、临时的对象，内部持有两个东西：
    1. 调用的主体（类）：无论是通过实例还是类访问 classmethod，__get__ 方法都会获取到调用者的类。（instance.__class__ 或 MyClass 本身）。
    2. 原始的包装函数 ( self.__func__ )。
  • 当这个绑定方法对象被调用时（即 __call__ 被触发），它会将那个类作为第一个参数（cls）插入到原始函数的参数列表前面,然后再调用原始函数。

参数传递的时机与方式（核心差异）

这是最直接影响你编码行为的地方。

• staticmethod：

  • 没有任何隐式参数传递。
  • 它就像把一个普通函数放到了类命名空间里，调用 MyClass.func(x) 或 instance.func(x) 时,你传入的所有参数都会被原封不动地传递给被包装的函数。
  • 在 Python 字节码层面，访问静态方法后，你得到的直接就是那个函数对象，然后执行一次普通的函数调用（CALL_FUNCTION）。

• classmethod：

  • 隐式传递第一个参数（类）。
  • 当你写 MyClass.method(x) 时，CPython 内部实际上执行的是：bound_method = MyClass.method -> 得到一个绑定方法对象。bound_method(x) -> 等价于 wrapped_function(MyClass, x)。
  • cls 参数是自动注入的，你不需要、也不应该在调用时手动传入类。
  • 在字节码层面，访问类方法会触发 __get__ 并创建一个绑定方法对象，随后调用这个对象时，使用的是 CALL_METHOD （Python 3.7+）或 LOAD_METHOD / CALL_METHOD 指令，这些指令会隐式地处理 self 或 cls 的绑定。

对继承的影响

这一点非常关键,可以体现出两者底层实现的不同。

• staticmethod：

  • 完全忽略继承。 无论你在哪个子类上调用，它作为普通函数的特性导致它不会获得任何关于调用者类的信息，如果你在 classmethod 里需要知道是哪个子类调用了它（工厂模式），staticmethod 是做不到的。

• classmethod：

  • 遵守继承规则。 当你通过子类调用一个从父类继承来的 classmethod 时，它的 __get__ 方法会确定调用类是子类，并把它作为 cls 参数传入。
  • 这实现了非常强大且优雅的模式（如工厂模式、多态）。

class Base:
    @classmethod
    def create(cls):
        # cls 可能是 Base 的子类
        print(f"Creating instance of {cls.__name__}")
        return cls()
    @staticmethod
    def info():
        # 完全没有 cls 信息
        print("This is a base info.")
class Child(Base):
    pass
# 类方法：自动传入 Child 类
c = Child.create()  # 输出: Creating instance of Child
# 静态方法：丢失了 Child 的上下文
Child.info()        # 输出: This is a base info.

内部存储与函数签名

• staticmethod 和 classmethod 都接受一个可调用对象（通常是函数）作为参数并存储它。
• 在 Python 3.10+，staticmethod 有了 __wrapped__ 属性,可以直接访问其包装的函数。
• classmethod 包装的函数可以通过 .__func__ 属性访问。
• inspect.signature 的行为不同：
  • 对于 staticmethod，inspect.signature 直接反映包装函数的签名（不包括任何隐式参数）。
  • 对于 classmethod，inspect.signature 显示的签名会移除第一个参数 cls，因为它在调用时会被自动填充，这是通过 @classmethod 装饰器的元数据处理实现的。

总结表

一句话总结底层区别：

staticmethod 在底层只是将一个普通的函数对象存储在类的 __dict__ 中，并通过 __get__ 原样返回，而 classmethod 则是一个类绑定器，它的 __get__ 会创建一个绑定方法对象，这个对象在调用时会强制将调用它的类作为第一个参数注入到被包装函数中。

标签： staticmethod classmethod