Python可变参数args与kwargs详解【教程】

Python中的*args和**kwargs是实现函数灵活调用的核心机制：*args将多余的位置参数自动打包为元组，**kwargs将未声明的关键字参数收集为字典，二者严格遵循“必选参数→*args→**kwargs”的顺序，既支持动态接收任意数量参数，也支持通过*和**解包列表、元组或字典进行高效传参；掌握它们不是死记语法，而是理解何时需要抽象参数边界、如何在装饰器、API封装和参数透传等真实场景中让代码更健壮、复用性更强。

Python 中的 *args 和 **kwargs 是处理可变数量参数的核心机制，它们让函数更灵活、复用性更强。关键不在于记住语法，而在于理解“什么时候该用、怎么传、怎么接”。

什么是 *args：接收任意多个位置参数

*args 用于捕获调用时传入的**多余位置参数**（即没有对应形参名的参数），自动打包成一个 tuple。它必须写在普通参数之后、**kwargs 之前。

示例：

def greet(name, *hobbies):
    print(f"Hi {name}!")
    print("Your hobbies:", hobbies)  # hobbies 是 tuple
<p>greet("Alice", "reading", "swimming", "coding")</p><h1>输出：</h1><h1>Hi Alice!</h1><h1>Your hobbies: ('reading', 'swimming', 'coding')</h1>

• 如果只传必需参数，*args 接收到的是空 tuple ()
• 不能用关键字方式传给 *args 参数（如 greet(name="Bob", "tennis") 会报错）
• 名字不固定，*args 只是约定俗成；写成 *things 或 *rest 也合法

什么是 **kwargs：接收任意多个关键字参数

**kwargs 捕获所有**未被显式声明的关键字参数**，自动打包成一个 dict。它必须放在参数列表最后。

示例：

def profile(name, **info):
    print(f"Name: {name}")
    print("Extra info:", info)  # info 是 dict
<p>profile("Tom", age=30, city="Shanghai", job="Engineer")</p><h1>输出：</h1><h1>Name: Tom</h1><h1>Extra info: {'age': 30, 'city': 'Shanghai', 'job': 'Engineer'}</h1>

• 键必须是合法标识符（不能是数字或表达式），值可以是任意类型
• 若没传额外关键字参数，**kwargs 得到的是空字典 {}
• 和 *args 一样，**kwargs 是命名习惯，实际可用 **options 等

组合使用：*args + **kwargs 的典型顺序

当函数既要支持任意位置参数、又要支持任意关键字参数时，标准写法是：

def func(required, *args, **kwargs):
    ...

这个顺序不可颠倒：必选参数 → *args → **kwargs。Python 靠这个顺序区分参数类型。

• required 必须提供（除非有默认值）
• *args 接收剩下未匹配的位置参数
• **kwargs 接收所有未匹配的关键字参数
• 常见于装饰器、封装底层函数、API 适配层等场景

实际技巧：解包传递参数

*args 和 **kwargs 不仅用于定义函数，也常用于“解包”已有的数据结构来调用函数。

• 用 * 解包序列（list/tuple）作为位置参数：func(*my_list)
• 用 ** 解包字典作为关键字参数：func(**config_dict)
• 可混合使用：func(a, *b, c=10, **d)
• 这是实现“参数透传”的基础，比如写一个通用日志装饰器，不关心被装饰函数收什么参数

好了，本文到此结束，带大家了解了《Python可变参数args与kwargs详解【教程】》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！