args解包可迭代对象为位置参数,kwargs解包字典为关键字参数;调用时是“放”,定义时是“收”;顺序为位置参数→args→关键字参数→kwargs;装饰器中必用以兼容任意签名。

传参时*args和**kwargs到底在解包什么
它们不是语法糖,是明确的解包操作符:一个把序列解成位置参数,一个把字典解成关键字参数。你写*my_list,Python 就按顺序把my_list[0]、my_list[1]…当参数挨个塞进函数;写**my_dict,就拿my_dict的键当参数名、值当参数值去匹配。
常见错误现象:TypeError: my_func() takes 2 positional arguments but 3 were given——其实是你传了*[1, 2, 3],但函数只定义了两个def my_func(a, b),第三个没地方放。
- 只有函数定义里用
*args是“收”,调用时用*args是“放”(解包),别混 -
*args只能解包可迭代对象(list/tuple/range等),不能是int或None -
**kwargs解包的对象必须是dict或类字典(有keys()和__getitem__),否则报TypeError: argument after ** must be a mapping - 解包顺序不能乱:位置参数 →
*args→ 关键字参数 →**kwargs,中间插个**kwargs再跟位置参数会直接SyntaxError
函数定义里def f(a, *args, b=1, **kwargs)这种写法为什么合法
这是 Python 3.0+ 支持的“仅限关键字参数”(keyword-only arguments)写法。b=1前面的*不是*args,它只是个分隔符,表示b之后所有带默认值的参数都必须显式写名字调用。
使用场景:当你想强制用户说明意图,比如f(1, 2, 3, b=4, c=5)中b必须写出来,不能靠位置猜。
- 没默认值的 keyword-only 参数(如
def f(*, x))调用时f(x=1)合法,f(1)直接报TypeError: f() missing 1 required keyword-only argument: 'x' -
*args后面还能跟多个 keyword-only 参数,但**kwargs必须在最后 - 这种写法对 API 设计友好,但调试时容易漏掉那个
*,导致以为b是普通默认参数,结果调用失败
*args和**kwargs在装饰器里为什么几乎必用
因为装饰器要原封不动转发被装饰函数的所有调用方式,而你根本不知道它接收什么参数。不用*args和**kwargs,装饰器一加,原函数带关键字参数就崩。
典型错误:def log(func): def wrapper(): print('call'); return func();return wrapper——这个wrapper完全不支持任何参数,@log后调用f(1, x=2)直接TypeError。
- 正确写法一定是
def wrapper(*args, **kwargs): ... return func(*args, **kwargs) - 如果装饰器自己也要加参数(比如
@retry(times=3)),那得套三层函数,最内层才负责接*args/**kwargs,漏一层就转发失败 - 性能上基本无影响,Python 解包开销极小;但 IDE 可能无法推导被装饰函数的签名,类型提示需额外处理(如
typing.ParamSpec)
解包嵌套时*[*a, *b]和{**x, **y}的坑
Python 支持多层解包,但规则很直白:只展开一层,且同类型才能拼。你写*[*a, *b],本质是先构造新列表[*a, *b]再解包;{**x, **y}是依次更新字典,后者键会覆盖前者。
常见错误现象:TypeError: unsupported operand type(s) for +: 'int' and 'list'——你以为*a + *b能拼,其实+不支持解包语法,必须写成*([*a] + [*b])或直接*itertools.chain(a, b)。
-
*a不能单独出现在表达式中间,比如func(1, *a, 2)合法,但1 + *a + 2语法错误 -
{**x, **y}中如果x和y有同名 key,y的值生效,没有警告,容易埋逻辑 bug - 嵌套解包不递归:
*[[1,2], [3,4]]传给函数,收到的是两个参数[1,2]和[3,4],不是1,2,3,4;真要展平得用itertools.chain.from_iterable
最常被忽略的是:解包行为发生在调用/定义时刻,不是运行时动态决定的。传进去的是什么结构,就解出什么参数——别指望*args能自动识别“该不该再解一层”。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











