直接传 *args, **kwargs 报错是因位置与关键字参数混用导致同名参数重复赋值，正确做法是避免在解包时额外传同名关键字参数，或先从 kwargs 中移除再显式传递。
为什么直接传 *args, **kwargs 有时会报错 TypeError: got multiple values for argument
这不是 *args 或 **kwargs 本身的问题，而是调用时位置参数和关键字参数混用不当导致的。比如原函数定义为 def f(a, b=1)，而你写成 f(*args, b=2, **kwargs)，又恰好 args 里有两个值，那 a 和 b 就会被重复赋值。
正确做法是：确保所有显式传入的关键字参数，在 *args 中不对应同名位置参数；更稳妥的是——只用 *args, **kwargs 解包，不额外插入关键字参数。
- ❌ 错误示例：
target_func(*args, timeout=5, **kwargs)（若args已含timeout对应位置值） - ✅ 安全写法：
target_func(*args, **kwargs)（完全透传） - ⚠️ 特殊情况需覆盖某参数？先从
kwargs里 pop 掉，再显式传，避免冲突
如何在装饰器里完整保留原函数签名并透传参数
仅靠 *args, **kwargs 调用能跑通，但会丢失原始函数的 __name__、__doc__ 和类型提示，影响调试和 IDE 补全。这时候不能只写 def wrapper(*args, **kwargs): return func(*args, **kwargs)。
必须配合 @functools.wraps(func)，它会把源函数的元数据复制到 wrapper 上：
import functools
<p>def log_call(func):
@functools.wraps(func) # ← 关键！否则 help(func) 看不到原 docstring
def wrapper(*args, *<em>kwargs):
print(f"Calling {func.<strong>name</strong>}")
return func(</em>args, **kwargs)
return wrapper
</p>
- 不加
@functools.wraps：被装饰后func.__name__变成'wrapper'，help()显示空文档 - 加了之后：
inspect.signature(func)仍能正确获取原始参数结构 - 注意：
functools.wraps不处理类型提示的自动继承，Python 3.10+ 可用typing.ParamSpec做更强类型安全
*args 和 **kwargs 在不同 Python 版本中的兼容性差异
基本语法从 Python 2.0 就支持，但细节行为有变化。最常踩坑的是 Python 3.8+ 引入的 positional-only 参数（/ 分隔符），它会影响 **kwargs 的可用范围。
例如：
def legacy_api(x, y, /, z, *, w):
return x + y + z + w
-
x和y只能按位置传，不能出现在**kwargs中 - 若你尝试
legacy_api(**{'x': 1, 'y': 2, 'z': 3, 'w': 4})→ 直接报错TypeError: legacy_api() got some positional-only arguments passed as keyword arguments - 所以「原样传递」的前提是：调用方知道目标函数的参数约束；盲目
**kwargs解包可能失败 - Python 3.12 开始，
inspect.Signature.bind_partial()可提前校验参数是否合法，比直接 try/except 更主动
什么时候不该用 *args, **kwargs 透传，而该显式列参
透传不是银弹。当目标函数参数少、稳定、且你需做中间处理（如类型转换、默认值填充、日志记录）时，显式声明反而更清晰、更易维护。
- 比如封装 requests.get：写
def my_get(url, params=None, timeout=10, **kwargs)比def my_get(*args, **kwargs)更好——你能控制timeout默认值，也能校验url是否为空 - IDE 和静态检查工具（如 mypy）对显式参数支持更好；
*args, **kwargs会让类型推导失效 - 性能上几乎无差别，但可读性差距很大：看到
send_email(to, subject, body, cc=None)就懂用途，看到send_email(*args, **kwargs)得翻源码
真正需要透传的场景其实很窄：通用装饰器、框架钩子、动态代理、测试 mock 替换——这些地方你根本不知道下游函数长什么样，才必须依赖 *args, **kwargs。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
