调用时必须用或对容器拆包:传列表/元组加(如func(my_list)),传字典加(如func(*my_dict));否则容器被当单个参数导致typeerror。

Python里*args和**kwargs到底怎么传进去
不是“定义时用”,而是“调用时传”——很多人卡在这一步:函数明明写了*args,自己调用时却直接传了个列表,结果报错TypeError: func() takes 1 positional argument but 2 were given。
关键在「拆包」:传入的容器(如list、dict)必须显式加*或**才能解构成独立参数。
- 传
list或tuple→ 前面加*,比如func(*my_list) - 传
dict→ 前面加**,比如func(**my_dict) - 混用顺序不能错:
*args必须在**kwargs前面,调用时也一样:func(a, *b, **c) - 如果忘了加
*,my_list会作为一个整体当第1个位置参数传进去,跟*args预期的“多个单独参数”冲突
为什么func(*[1,2], **{'x':3})能跑,但func(*[1,2], {'x':3})就报错
因为**不是可选语法糖,它是强制要求的解包标记。没有**,{'x':3}就是个普通dict对象,会被当作位置参数传给*args,而*args只收非关键字参数,dict又不匹配函数签名里的关键字形参名,自然崩。
-
*[1,2]→ 拆成1, 2两个位置参数 -
**{'x':3}→ 拆成x=3一个关键字参数 -
{'x':3}(没**)→ 就是dict本身,位置参数,类型/含义都不对 - 错误信息通常是
TypeError: func() got an unexpected keyword argument 'x'(漏**)或got multiple values for argument 'x'(重复传了x)
装包(定义函数时用*args/**kwargs)和拆包(调用时用*/**)不是对称操作
装包是把多余参数收进来,拆包是把容器发出去;但两者不互逆——你不能靠*args原样还原出调用时的list,它只是个tuple;**kwargs收进来也是dict,但键必须是字符串,且会丢失原始调用中的顺序(Python 3.7+ dict保持插入序,但语义上不保证)。
立即学习“Python免费学习笔记(深入)”;
-
*args收进来永远是tuple,哪怕你传的是list或range -
**kwargs收进来是dict,所有键被转成str,非字符串键会直接报错 - 想保留原始结构?得自己存:比如
def f(*a, _raw_args=None, **kw): ...,但这就不是标准用法了 - 性能上,
*args比手动收集sys.argv[1:]之类稍重一点,但日常完全忽略不计
实际场景中容易漏掉的兼容性细节
写工具函数或装饰器时,常要透传参数,这时*args和**kwargs看着简单,一动就翻车。
- 被装饰函数有
keyword-only参数(如def g(a, *, b=1)),传**kwargs时b必须显式存在,否则g(*args, **kwargs)会报missing 1 required keyword-only argument: 'b' - 子类重写父类方法并用
*args, **kwargs转发时,注意父类是否用了__slots__或@property,某些特殊属性不会进**kwargs - 用
functools.partial预设参数后,再用*args传参,顺序容易混乱,建议改用lambda或显式包装 - 调试时打印
args和kwargs没问题,但别在日志里直接str(kwargs)——万一里面有不可序列化对象(如socket),会炸
最常被忽略的点:*args和**kwargs只是语法糖,背后没有魔法。它们不改变参数本质,也不自动做类型检查或默认值填充——该你操心的地方,一个没少。










