编程 functools.partial 不是柯里化:缺 __name__、不是描述符、关键字参数被静默覆盖

2026-11-17 00:04:29

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。

复制全文 生成海报 Python 部分函数应用 functools 闭包 性能

推荐文章

程序员茄子在线接单