Python可变参数args与kwargs详解

本文深入剖析了Python中*args与**kwargs的本质——它们并非语法糖，而是明确的解包操作符：*args将可迭代对象（如列表、元组）按顺序解包为位置参数，**kwargs则将字典或类字典对象解包为关键字参数；关键在于区分“定义时收”与“调用时放”，严格遵循参数顺序（位置参数 → *args → 关键字参数 → **kwargs），并详解了仅限关键字参数、装饰器中不可或缺的转发机制、嵌套解包的常见陷阱（如{**x, **y}键覆盖、*[[1,2],[3,4]]不自动展平）以及典型TypeError根源，帮助开发者真正理解其运行逻辑，写出健壮、兼容、可维护的Python代码。

传参时*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可变参数args与kwargs详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！