当前位置:首页>python>Python可变参数——处理不定数量参数的利器

Python可变参数——处理不定数量参数的利器

  • 2026-10-11 17:28:11
Python可变参数——处理不定数量参数的利器

一、什么是可变参数?

在编写函数时,有时我们无法预先知道调用者会传递多少个参数。例如,一个求和的函数,可能希望它能计算任意多个数字的和。Python 提供了可变参数的机制,允许函数接受任意数量的参数。

可变参数分为两种:

  • • *args:接收任意数量的位置参数,打包成元组(tuple)。
  • • **kwargs:接收任意数量的关键字参数,打包成字典(dict)。
defsum_all(*args):
    total = 0
for num in args:
        total += num
return total

print(sum_all(1, 2, 3))       # 6
print(sum_all(10, 20, 30, 40)) # 100

二、为什么需要可变参数?

  • • 灵活性:函数可以处理不同数量的输入,无需重载。
  • • 简化调用:调用者不需要将多个参数打包成列表或元组。
  • • 扩展性:在装饰器、包装函数等高级用法中,可变参数是必不可少的。
  • • 兼容性:当需要传递不确定数量的参数给另一个函数时,可变参数非常方便。

三、*args —— 可变位置参数

3.1 基本用法

在函数定义中,使用 *参数名 的形式来接收任意数量的位置参数。习惯上参数名取 args,但可以是任何合法标识符。

deffunc(*args):
print(args)          # args 是一个元组
print(type(args))    # <class 'tuple'>

func(1, 2, 3, "hello")
# 输出:
# (1, 2, 3, 'hello')
# <class 'tuple'>

3.2 使用 *args 进行求和

defaverage(*numbers):
ifnot numbers:      # 处理没有参数的情况
return0
returnsum(numbers) / len(numbers)

print(average(1, 2, 3, 4))   # 2.5
print(average(10, 20))        # 15.0
print(average())              # 0

3.3 与其他普通参数共存

*args 必须放在所有普通位置参数之后,但可以在默认参数之前或之后?实际上,默认参数可以放在 *args 之前或之后,但通常放在之前更常见。注意:在 *args 之后的参数只能作为关键字参数传递(命名关键字参数)。

deffunc(a, b, *args):
print(f"a={a}, b={b}, args={args}")

func(1, 2, 3, 4, 5)   # a=1, b=2, args=(3,4,5)

如果想把默认参数放在 *args 之后,那么该默认参数必须通过关键字传递。

deffunc(*args, default=10):
print(f"args={args}, default={default}")

func(1, 2, 3)                 # args=(1,2,3), default=10
func(1, 2, 3, default=20)     # args=(1,2,3), default=20

3.4 解包列表/元组作为 *args 传递

如果已经有一个列表或元组,想要将其元素作为位置参数传递给一个接受 *args 的函数,可以在调用时使用 * 解包。

defsum_all(*args):
returnsum(args)

numbers = [10, 20, 30]
print(sum_all(*numbers))   # 60

四、**kwargs —— 可变关键字参数

4.1 基本用法

**kwargs 接收任意数量的关键字参数,并将它们打包成一个字典。习惯上参数名取 kwargs。

deffunc(**kwargs):
print(kwargs)
print(type(kwargs))

func(name="张三", age=25, city="北京")
# 输出:
# {'name': '张三', 'age': 25, 'city': '北京'}
# <class 'dict'>

4.2 遍历 **kwargs

defprint_info(**info):
for key, value in info.items():
print(f"{key}: {value}")

print_info(name="李四", job="工程师", salary=20000)
# 输出:
# name: 李四
# job: 工程师
# salary: 20000

4.3 与其他参数共存

**kwargs 必须放在所有参数的最后,包括 *args 和普通参数之后。

deffunc(a, b, *args, **kwargs):
print(f"a={a}, b={b}, args={args}, kwargs={kwargs}")

func(1, 2, 3, 4, x=10, y=20)
# a=1, b=2, args=(3,4), kwargs={'x':10, 'y':20}

4.4 解包字典作为 **kwargs 传递

如果已经有一个字典,想要将其键值对作为关键字参数传递给一个接受 **kwargs 的函数,可以在调用时使用 ** 解包。

defdisplay(**kwargs):
for k, v in kwargs.items():
print(f"{k} = {v}")

data = {"name": "王五", "score": 95}
display(**data)   # name = 王五  score = 95

五、*args 和 **kwargs 的组合使用

两者可以一起使用,接收任意位置参数和任意关键字参数。此时,*args 必须在 **kwargs 之前。

defuniversal_func(*args, **kwargs):
print("位置参数:", args)
print("关键字参数:", kwargs)

universal_func(1, 2, 3, name="Alice", age=30)
# 输出:
# 位置参数: (1, 2, 3)
# 关键字参数: {'name': 'Alice', 'age': 30}

这种形式常用于编写装饰器、包装函数或需要转发参数的场景。


六、实战案例

案例1:灵活的日志函数

deflog(level, *messages, **metadata):
"""记录日志,可接受任意数量的消息和额外的元数据"""
    prefix = f"[{level}]"
for msg in messages:
print(f"{prefix}{msg}")
if metadata:
print("附加信息:", metadata)

log("INFO", "系统启动", "用户登录")
log("ERROR", "数据库连接失败", "重试3次", user="admin", db="mysql")

案例2:装饰器模板

defmy_decorator(func):
defwrapper(*args, **kwargs):
print("调用函数前")
        result = func(*args, **kwargs)
print("调用函数后")
return result
return wrapper

@my_decorator
defadd(a, b):
return a + b

print(add(3, 5))   # 调用函数前  调用函数后  8

案例3:计算任意数量的平均值(处理无参数情况)

defaverage(*numbers):
iflen(numbers) == 0:
return0
returnsum(numbers) / len(numbers)

print(average(90, 85, 92))   # 89.0
print(average())              # 0

案例4:合并多个字典

defmerge_dicts(**dicts):
"""合并多个字典(实际参数是多个关键字参数字典?不太对)"""
# 更合理的实现:接收多个字典作为位置参数,用 ** 解包
pass

# 更实用的例子:接收任意数量的字典,合并为一个
defmerge(*dicts):
    result = {}
for d in dicts:
        result.update(d)
return result

d1 = {"a": 1, "b": 2}
d2 = {"c": 3, "d": 4}
d3 = {"e": 5}
print(merge(d1, d2, d3))   # {'a': 1, 'b': 2, 'c': 3, 'd': 4, 'e': 5}

案例5:模拟 print 函数的行为(简化版)

defmy_print(*args, sep=' ', end='\n'):
    output = sep.join(str(arg) for arg in args)
print(output, end=end)

my_print("Hello", "World")               # Hello World
my_print("a", "b", "c", sep=',')          # a,b,c
my_print("Done", end='!!!\n')             # Done!!!

七、注意事项

  1. 1. 参数顺序:在函数定义中,参数顺序必须是:普通位置参数、默认参数、*args、命名关键字参数、**kwargs。
  2. 2. *args 接收的是元组:即使只传一个参数,args 也是一个单元素元组。
  3. 3. **kwargs 接收的是字典:键都是字符串,值可以是任意类型。
  4. 4. 不要滥用:如果函数逻辑依赖于特定数量的参数,用可变参数反而会降低可读性。
  5. 5. *args 和 **kwargs 的名称不是固定的:可以使用任何名字,如 *numbers、**options,但约定俗成使用 args 和 kwargs。
  6. 6. 在调用时使用 * 和 ** 解包:可以很方便地将序列或字典解包传递给函数。
  7. 7. 可变参数不能有默认值:*args 和 **kwargs 本身没有默认值,它们只是收集多余的参数。

八、总结

特性
*args**kwargs
收集的内容
多余的位置参数
多余的关键字参数
类型
元组 (tuple)
字典 (dict)
放置位置
在普通参数之后,**kwargs 之前
必须在所有参数的最后
解包方式
调用时用 *seq
调用时用 **dict
常见用途
求和、平均值、转发位置参数
处理任意关键字参数、配置选项

可变参数是 Python 灵活性的重要体现。掌握 *args 和 **kwargs,可以让你编写出更加通用和强大的函数。在装饰器、框架设计、回调函数等场景中,它们几乎是必不可少的工具。

希望本文能帮助你彻底理解并熟练运用可变参数。

最新文章

随机文章