必须用args和*kwargs的场景是调用方不可控时,如写装饰器、封装第三方接口、通用回调钩子;二者需按固定顺序使用,且需注意类型校验、键名冲突、可读性与测试覆盖。

什么时候必须用 *args 和 **kwargs?
当你写一个函数,但无法提前确定调用方会传几个位置参数、或哪些关键字参数时——比如封装日志函数、代理其他函数、做装饰器、或者实现通用回调接口。这时候硬编码参数名会立刻报 TypeError: unexpected keyword argument 或 missing 1 required positional argument。
常见错误现象:把 *args 当成“可选参数”来用,结果发现它其实强制接收所有多余的位置参数,哪怕你只想要其中某几个;或者误以为 **kwargs 能自动解包字典传给下层函数,却忘了它只是个 dict,不调用 ** 解包就只是传了个字典对象过去。
-
*args接收所有未匹配的位置参数,打包成 tuple;它必须出现在普通参数之后、**kwargs之前 -
**kwargs接收所有未匹配的关键字参数,打包成 dict;它必须是参数列表的最后一个 - 如果函数定义里有
def f(a, *args, b=10, **kwargs),那么b是 keyword-only 参数,调用时必须显式写b=...
*args 和 **kwargs 怎么安全地转发给下游函数?
转发不是简单地把变量名写过去,关键在「解包」。直接传 args 或 kwargs 会被当成单个参数,类型错、数量错、语义也错。
正确做法是:调用时加 * 和 ** 前缀重新解包。
def wrapper(func, *args, **kwargs):
print("Calling", func.__name__)
return func(*args, **kwargs) # ← 这里才是解包转发
容易踩的坑:
- 混用顺序:
func(**kwargs, *args)是语法错误,必须*args在前、**kwargs在后 - 重复传参:
func(x, *args, x=1)会导致x被赋值两次,触发TypeError - 类型穿透问题:如果
func本身不接受任意参数(比如签名是def f(x: int)),那即使你转发了*args,运行时仍会报错——*args不改变被调函数的约束
如何在装饰器里同时处理固定参数和动态参数?
装饰器是最典型的应用场景。你需要保留原函数的签名,同时让装饰后的函数能接收任意参数。Python 3.8+ 推荐用 functools.wraps,但核心仍是参数透传逻辑。
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
from functools import wraps
<p>def log_calls(func):
@wraps(func)
def inner(*args, *<em>kwargs):
print(f"→ {func.<strong>name</strong>}({args}, {kwargs})")
result = func(</em>args, **kwargs)
print(f"← {result}")
return result
return inner</p>
注意点:
- 别漏掉
@wraps(func),否则help()和inspect.signature()看到的是inner的空签名,不是原函数的 - 如果你需要在装饰器里预处理某些参数(比如统一加 timeout),应该先从
*args/**kwargs中提取、修改,再解包调用,而不是覆盖整个参数包 - 对
**kwargs做键检查时,用kwargs.pop('timeout', None)比kwargs.get()更安全,避免把不该透传的参数也送下去
为什么有时 *args 是空 tuple、**kwargs 是空 dict,但函数仍报错?
因为错误不在你这一层,而在被调函数内部。空 *args 和空 **kwargs 只表示“没多传参数”,不代表“满足了目标函数的所有必需参数”。例如:
def target(a, b):
return a + b
<p>def proxy(*args, *<em>kwargs):
return target(</em>args, **kwargs)</p><p>proxy(1) # TypeError: target() missing 1 required positional argument: 'b'</p>
这说明 *args 和 **kwargs 是被动接收机制,不提供参数校验能力。它们解决的是“多出来怎么收”,不是“缺的怎么补”。真正要健壮,得结合 inspect.signature() 做运行时参数分析,或者用类型提示配合 mypy 静态检查。
最常被忽略的一点:*args 和 **kwargs 看似灵活,实则把参数契约从函数定义移到了调用现场——一旦下游函数签名变更,你的转发逻辑不会报错,但运行时崩,而且 traceback 很难定位到是转发层的问题。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










