Python通过描述符协议（descriptor protocol）实现方法绑定：当函数作为类属性被实例访问时，其__get__方法自动将实例作为第一个参数注入；而类访问或直接赋值给实例时则不触发该机制。
python通过描述符协议（descriptor protocol）实现方法绑定：当函数作为类属性被实例访问时，其__get__方法自动将实例作为第一个参数注入；而类访问或直接赋值给实例时则不触发该机制。
在Python面向对象编程中，一个看似反直觉却极为关键的现象是：即使你把一个普通函数显式赋值为类属性，只要通过实例访问它，Python就会自动将该实例作为第一个参数传入——就像调用标准的实例方法一样。这并非“bug”，而是Python底层设计中函数对象实现描述符协议（__get__方法）所导致的必然行为。
? 核心原理：函数是描述符（Function is a Descriptor）
所有普通函数对象（function类型）在Python中都实现了描述符协议，即定义了 __get__(self, obj, objtype) 方法：
- 当函数从实例（
obj非None）中被获取（如b.fn），__get__返回一个绑定方法（bound method），该方法在调用时自动前置obj作为第一个参数； - 当函数从类（
obj为None）中被获取（如B.fn），__get__直接返回原函数本身（即非绑定函数），调用时不自动传参。
class B:
def instance_fn(self, x):
return f"called with {self} and {x}"
def plain_func(x):
return f"plain: {x}"
B.fn = plain_func # 将普通函数赋给类属性
b = B()
print(B.fn) # <function plain_func at> —— 类访问 → 原函数
print(b.fn) # <bound method ... of object>> —— 实例访问 → 绑定方法！
print(b.fn(42)) # (<__main__.b object at>, 42) → self 被自动注入！</__main__.b></bound></function>
✅ 这正是你观察到
b.fn()输出含实例对象的原因：b.fn触发了plain_func.__get__(b, B)，返回绑定方法，等价于lambda *a, **k: plain_func(b, *a, **k)。
⚠️ 静态方法为何“失效”？——装饰器的本质是包装
@staticmethod 并非让函数“失去描述符特性”，而是用 staticmethod 对象包装原函数，并重写其 __get__：
-
staticmethod.__get__(self, obj, objtype)总是返回原始函数对象（不绑定、不注入任何参数）； - 但一旦你执行
BStatic.fn = BStatic.static_fn，你实际是把BStatic.static_fn的返回值（即被包装后的staticmethod对象）赋给了fn—— 等等，不对！
⚠️ 关键陷阱在此：BStatic.static_fn 是一个 staticmethod 对象，但它本身不可调用（除非 Python ≥3.10）。而你在代码中能成功调用 bs.fn()，恰恰说明：你拿到的不是 staticmethod 对象，而是它内部封装的原始函数。
这是因为：当你通过点号访问 BStatic.static_fn 时，staticmethod.__get__ 被触发，返回的是原始函数（static_fn 的函数体），而非 staticmethod 对象本身。所以 BStatic.fn = BStatic.static_fn 实际上等价于：
BStatic.fn
| 访问方式 | 普通函数（类属性） | @staticmethod |
@classmethod |
|---|---|---|---|
Cls.method() |
func() |
func() |
func(Cls) |
inst.method() |
func(inst) |
func() |
func(Cls) |
Cls.__dict__['m'] |
|
|
|
? 实践建议与避坑指南
-
不要依赖“类属性函数自动绑定”做逻辑设计：它易混淆且违背显式意图。若需实例上下文，请明确定义为实例方法（
def method(self, ...)）； -
静态工具函数请始终使用
@staticmethod并直接定义在类中，避免外部赋值覆盖绑定行为； -
调试绑定问题时，善用
type(obj.attr)和obj.attr.__func__：print(type(b.fn)) # <class> ← 绑定方法 print(type(B.fn)) # <class> ← 普通函数 print(type(B.__dict__['fn'])) # <class> 或 <class></class></class></class></class>
-
若需完全解除绑定（如回调注册），请将函数赋值给实例属性（如
b.fn = plain_func），因为实例属性不触发描述符协议。
理解这一机制，不仅解开了“为什么self会神秘出现”的疑惑，更让你真正掌握Python方法调用背后的统一模型：一切皆对象，一切绑定皆由描述符驱动。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
