Python 教程 / 可变参数与展开:*args、**kwargs

在函数定义中,*args把额外位置实参收集为元组,**kwargs把额外关键字实参收集为字典。在调用处,*和 **反过来将已有数据展开为实参,先分清出现的位置与方向。

区分收集与展开的方向

args、kwargs 是惯用名称,并不是必须使用的关键字,真正决定作用的是星号语法。下面示例用 *amounts收集金额,比泛称 args 更能表达用途。

位置 写法 作用
定义 def f(*args) 收集额外位置实参为元组。
定义 def f(**kwargs) 收集额外关键字实参为字典。
调用 f(*values) 将可迭代对象的元素分别传为位置实参。
调用 f(**options) 将字符串键映射展开为关键字实参。

固定输入本来很清楚的函数,不必全部改成可变参数,否则允许哪些名称、哪些值必填反而不明显。基础调用规则见位置参数、关键字参数与默认值,星号规则可查Python 官方任意实参列表说明。

运行可变数量合计与选项描述

将下面完整内容保存为独立练习目录中的 UTF-8 文件 varargs.py,在项目环境执行 python varargs.py。macOS、Ubuntu 若使用 python3,按已确认的解释器运行。无需第三方依赖。

def total(*amounts, fee=0):
    return sum(amounts) + fee

def describe(**fields):
    return ", ".join(f"{key}={value}" for key, value in sorted(fields.items()))

values = [3500, 8000, 2500]
print(total(*values, fee=500))
options = {"category": "food", "currency": "KRW"}
print(describe(**options))

预期输出:

14500
category=food, currency=KRW

*values将三个整数分别传给 total,函数中的 amounts 是包含这三个值的元组。fee 位于 *amounts之后,是仅限关键字的选项,默认零;这里明确传入 500,所以 14000 加费用后为 14500。

**options将 category 和 currency 两个键值对作为关键字传入。describe 用 fields 字典接收后,按键排序,再把各项格式化为文本并连接。它只是描述选项,没有执行金额换算、保存或其他业务操作。

识别重复关键字与意外展开

**展开的键必须为字符串,也必须被目标函数的命名参数或可变关键字参数接收。describe(category="food", **{"category": "books"})把同一个关键字传了两次,会产生 TypeError,不会自动让后面的值覆盖前面的值。

这是函数调用规则,与构造或合并字典时相同键后值替换前值的规则不同。不能把“字典合并可以覆盖”推断成“调用时重复关键字也可以覆盖”。

字符串也是可迭代对象。total(*"123")会传入三个字符串字符,而不是一个整数 123;本例的 sum 无法按金额方式相加这些文本,因此会产生 TypeError。total(values)也不是 total(*values):前者只传一个列表实参,不会自动展开其中的整数。

包装函数转发时,定义中的 def wrapper(*args, **kwargs)先收集,内部的 func(*args, **kwargs)再展开。把 kwargs 字典当一个普通位置实参传给 func,和用 **kwargs传递命名选项是不同操作。需要保留原调用语义时,两类实参都要正确转发。

验证接口与默认行为

  1. 在 values 末尾加上 0,检查合计仍为 14500,但输入元素数量已增加。
  2. 移除调用中的 fee=500,检查默认费用为零,总数为 14000。
  3. 尝试同时直接提供 category 和通过映射展开同名 category,确认是重复参数错误。
  4. 恢复原始数据和 fee=500,重新核对完整两行输出。

没有金额时,total()在这个实现中得到 0,因为 sum 的默认起始值是零;total(fee=500)则得到 500。业务是否允许“只有费用、没有金额”需要单独规定,语法允许并不等于数据有效。

接受任意关键字不意味着应把未经检查的输入原样转交外部 API 或 SQL。需要验证允许的选项名、必填字段和数据类型,避免拼写错误被静默收下。输入本来是一个含义明确的记录列表时,接收一个明确的列表参数可能比任意位置实参更易维护。