functools.partial 不是柯里化:没有 __name__、不是描述符,关键字参数还会被静默覆盖
结论先行:functools.partial 只是一个保存了 (func, args, keywords) 的调用包装对象,调用时才把参数拼起来交给 func。它不生成新函数,也不做柯里化,所以没有 __name__、没有 __get__,属性只读、关键字可被覆盖。下面几条都是 Python 3.6.8 上的实测行为(官方文档)。
绑定之后,签名是推导出来的
import functools, inspect
def f(a, b, c=3): return a + b + c
p = functools.partial(f, 1)
p.func, p.args, p.keywords
# (, (1,), {})
inspect.signature(p)
# (b, c=3)
inspect.getfullargspec(p)
# FullArgSpec(args=['b', 'c'], varargs=None, varkw=None,
# defaults=(3,), kwonlyargs=[], kwonlydefaults=None, annotations={})
前导位置参数被移除。关键字绑定走另一条路:
inspect.signature(functools.partial(f, b=2))
# (a, *, b=2, c=3)
a 仍可按位置传,b 变成带默认值的仅关键字参数。inspect 能推导,但推导结果不等于 f 的真实签名——写装饰器、自动生成文档或做参数校验时,不要直接把 (b, c=3) 当成 f 的定义使用。
坑一:关键字被静默覆盖,位置重复报 TypeError
functools.partial(f, b=2)(1, b=99) # 103
functools.partial(f, 1)(a=2, b=3) # TypeError: f() got multiple values for argument 'a'
第二条是好事,冲突直接暴露。第一条不是:b=99 覆盖了预绑定的 b=2,1 + 99 + 3 = 103,全程没有任何提示。文档里的等价式写得很清楚:func(*args, *more_args, **{**keywords, **more_keywords}),后面的关键字字典直接合并覆盖。如果预绑定值是被调用方不该动的(超时、默认租户 id 之类),partial 给不了保护。
坑二:没有 __name__,__doc__ 得手写,args/keywords 只读
hasattr(p, '__name__') # False
hasattr(p, '__get__') # False
p.args = (2,) # AttributeError: readonly attribute
p.keywords = {'b': 2} # AttributeError: readonly attribute
p.__doc__ = 'add 1' # 可以写入
__name__ 缺失直接影响日志和反射代码的可读性;__doc__ 可赋值但要自己补。args/keywords 是只读属性,想改只能 functools.partial(p.func, 2, **p.keywords) 重建一个。
嵌套 partial 会自动合并 args:
functools.partial(functools.partial(f, 1), 2).args # (1, 2)
functools.partial(functools.partial(f, 1), 2)(10) # 13,10 落到 b 上
坑三:不是描述符,类里要用 partialmethod
class A:
m = functools.partial(f, 1)
A().m # functools.partial(, 1)
没有 __get__,实例访问拿到的还是那个 partial 对象,self 不会插进来,A().m() 实际调用的是 f(1)。
类内要用 partialmethod,它是描述符,self 插在 args 之前:
class A:
def m(self, a, b): return (type(self).__name__, a, b)
n = functools.partialmethod(m, 1)
A().n(2) # ('A', 1, 2)
坑四:pickle 跟着 func 走
pickle.loads(pickle.dumps(functools.partial(f, 1)))() # 6
pickle.dumps(functools.partial(lambda x: x, 1))
# PicklingError: Can't pickle at 0x...>
只有 func 和 args/keywords 都可 pickle 时,partial 才能序列化。用 lambda 拼出来的 partial 传不进多进程。partial 对象本身按身份哈希,可以当 dict key,但不能按值比较相等。
坑五:保存的是引用,不是创建那一刻的值
bag = []
p = functools.partial(f, 'x', bag)
bag.append(1)
p.args[1] is bag # True
args 元组里存的是原对象引用,创建之后对 bag 的修改,调用时全都看得见。要冻结值就传不可变副本。
性能:0.267s 与 0.235s
timeit,各 50 万次调用:
| 写法 | 耗时 |
|---|---|
functools.partial(f, 1) 后调用 | 0.267s |
手写闭包 def g(b): return f(1, b) | 0.235s |
差 13%,绝对值每次约 0.06µs。为了这点开销去改代码结构不划算,闭包多出来的可读性和 __name__ 通常更值钱。
一个对照表
| 场景 | 表现 |
|---|---|
| 关键字预绑定后被调用方再传 | 静默覆盖 |
| 位置预绑定后调用方用关键字传同名参数 | TypeError: got multiple values for argument 'a' |
inspect.signature | 推导,移除前导位置参数 |
__name__ / __get__ | 均不存在 |
args / keywords | 只读,AttributeError: readonly attribute |
| pickle | 取决于 func/args 是否可 pickle |
| 作 dict key、相等比较 | 身份哈希,不按值比较 |
同名但语义不同:PHP 8.6 的 PFA 在创建分部时就求值,Python 的 partial 保存引用、调用时才读——别照着 PHP 的心智模型写 Python。