*args 必须在 **kwargs 之前,否则报 SyntaxError;调用时位置参数和 *args 解包必须在关键字参数之前,否则 TypeError;装饰器中解包顺序错误或遗漏会导致参数错位或缺失。
*args 和 **kwargs 的位置不能调换Python 解析函数签名时严格按顺序处理参数:普通参数 → *args → **kwargs。如果把 **kwargs 写在 *args 前面,会直接报 SyntaxError: invalid syntax。
这是语法硬性限制,不是运行时错误,IDE 或解释器在读取函数定义时就会拒绝执行。
def f(a, **kwargs, *args): → 语法错误,无法通过解析def f(a, *args, **kwargs): → 合法,标准写法**kwargs 看起来“更通用”,也不能提前TypeError
即使函数定义正确,调用时如果位置参数、*args 解包、关键字参数混用不当,也会触发类型错误。关键在于:位置参数必须全部出现在关键字参数之前;*args 解包项不能出现在关键字参数之后。
f(1, 2, 3, x=4, *y) → 如果 y = [5],实际等价于 f(1, 2, 3, x=4, 5),报错:TypeError: f() got multiple values for argument 'x'(因为 5 被当作位置参数塞进本该是 x 的位置)f(1, *args, x=2, **kw) 是合法的;但 f(1, x=2, *args, **kw) 会出错 —— *args 不能出现在关键字参数之后**{'x': 99} 和显式 x=4 同时
TypeError: f() got multiple values for argument 'x'
*args 和 **kwargs 在装饰器里顺序错乱会破坏原函数接口装饰器内部转发调用时,若解包顺序写反,比如写成 func(**kwargs, *args),不仅语法报错,更常见的是误写为 func(*args, **kwargs) 以外的形式(如漏掉某个),导致原函数收不到参数或收到错位参数。
return func(**kwargs, *args) → 语法错误,**kwargs 不能在 *args 前return func(*args) 忘了传 **kwargs,结果原函数带关键字参数调用时直接 TypeError: unexpected keyword argument
func(args, kwargs)(没加 *),把元组和字典当两个普通参数传进去,彻底错位位置参数、*args 解包、显式关键字参数、**kwargs 解包之间存在覆盖优先级:越靠后的同名参数越生效。这不是“错乱”,但常被当成 bug。
f(1, 2, x=10, *([3],), **{'x': 20}) 中,x 最终是 20(**kwargs 覆盖显式 x=10)*([3],) 实际展开为 3,而函数签名是 def f(a, b, x=0),那 3 就会赋给 b,x 还是 20 —— 表面看没冲突,但语义已偏移**dict1 和 **dict2 合并传入,后者键名自动覆盖前者,且无提示