*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) 以外的形式(如漏掉某个),导致原函数收不到参数或收到错位参数。
这本书给出了一份关于python这门优美语言的精要的参考。作者通过一个完整而清晰的入门指引将你带入python的乐园,随后在语法、类型和对象、运算符与表达式、控制流函数与函数编程、类及面向对象编程、模块和包、输入输出、执行环境等多方面给出了详尽的讲解。如果你想加入 python的世界,David M beazley的这本书可不要错过哦。 (封面是最新英文版的,中文版貌似只译到第二版)
立即学习“Python免费学习笔记(深入)”;
- 典型错误:
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合并传入,后者键名自动覆盖前者,且无提示









