一、什么是可变参数?
在编写函数时,有时我们无法预先知道调用者会传递多少个参数。例如,一个求和的函数,可能希望它能计算任意多个数字的和。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. 参数顺序:在函数定义中,参数顺序必须是:普通位置参数、默认参数、
*args、命名关键字参数、**kwargs。 - 2.
*args 接收的是元组:即使只传一个参数,args 也是一个单元素元组。 - 3.
**kwargs 接收的是字典:键都是字符串,值可以是任意类型。 - 4. 不要滥用:如果函数逻辑依赖于特定数量的参数,用可变参数反而会降低可读性。
- 5.
*args 和 **kwargs 的名称不是固定的:可以使用任何名字,如 *numbers、**options,但约定俗成使用 args 和 kwargs。 - 6. 在调用时使用
* 和 ** 解包:可以很方便地将序列或字典解包传递给函数。 - 7. 可变参数不能有默认值:
*args 和 **kwargs 本身没有默认值,它们只是收集多余的参数。
八、总结
可变参数是 Python 灵活性的重要体现。掌握 *args 和 **kwargs,可以让你编写出更加通用和强大的函数。在装饰器、框架设计、回调函数等场景中,它们几乎是必不可少的工具。
希望本文能帮助你彻底理解并熟练运用可变参数。