Python函数中的*args与**kwargs详解：灵活处理可变参数
引言
在Python函数定义中，我们经常会看到*args和**kwargs这两个特殊的参数。它们是Python中处理可变数量参数的强大工具，能够让函数更加灵活和通用。本文将详细讲解它们的用法、区别以及实际应用场景。
1. *args的基本用法
*args用于在函数中接收任意数量的位置参数(positional arguments)，这些参数会被打包成一个元组(tuple)。
基本语法
def function_name(*args):
# 函数体示例1：简单的加法函数
def add_numbers(*args):
total = 0
for num in args:
total += num
return total
print(add_numbers(1, 2, 3)) # 输出: 6
print(add_numbers(10, 20, 30, 40)) # 输出: 100在这个例子中，我们可以传入任意数量的参数，函数会将它们全部相加。
示例2：与常规参数一起使用
def make_pizza(size, *toppings):
print(f"制作一个{size}寸的披萨，包含以下配料:")
for topping in toppings:
print(f"- {topping}")
make_pizza(12, '蘑菇', '洋葱', '芝士', '火腿')输出:
制作一个12寸的披萨，包含以下配料:
- 蘑菇
- 洋葱
- 芝士
- 火腿注意：*args必须放在常规参数之后。
2. **kwargs的基本用法
**kwargs用于接收任意数量的关键字参数(keyword arguments)，这些参数会被打包成一个字典(dictionary)。
基本语法
def function_name(**kwargs):
# 函数体示例1：收集用户信息
def build_profile(**kwargs):
profile = {}
for key, value in kwargs.items():
profile[key] = value
return profile
user_profile = build_profile(name='张三', age=30, occupation='工程师', city='北京')
print(user_profile)输出:
{'name': '张三', 'age': 30, 'occupation': '工程师', 'city': '北京'}示例2：与常规参数和*args一起使用
def car_info(make, model, **kwargs):
car_details = {
'make': make,
'model': model
}
car_details.update(kwargs)
return car_details
my_car = car_info('丰田', '凯美瑞', year=2020, color='银色', mileage=15000)
print(my_car)输出:
{'make': '丰田', 'model': '凯美瑞', 'year': 2020, 'color': '银色', 'mileage': 15000}注意：**kwargs必须放在所有参数的最后。
3. *args和**kwargs的组合使用
在实际开发中，我们经常需要同时使用*args和**kwargs来处理各种参数组合。
示例：通用日志函数
def log_message(level, *args, **kwargs):
print(f"[{level.upper()}] ", end="")
for arg in args:
print(arg, end=" ")
if kwargs:
print("\n附加信息:")
for key, value in kwargs.items():
print(f"{key}: {value}")
log_message("info", "系统启动完成", "所有服务正常", timestamp="2023-01-01 08:00:00", version="1.0.0")输出:
[INFO] 系统启动完成 所有服务正常
附加信息:
timestamp: 2023-01-01 08:00:00
version: 1.0.04. 参数解包
*和**不仅可以用于函数定义中收集参数，还可以用于函数调用时解包参数。
示例1：使用*解包序列
def print_coordinates(x, y, z):
print(f"坐标: X={x}, Y={y}, Z={z}")
point = (3, 7, 2)
print_coordinates(*point) # 等同于 print_coordinates(3, 7, 2)示例2：使用**解包字典
def setup_connection(host, port, username, password):
print(f"连接到 {host}:{port}")
print(f"用户名: {username}")
print("密码已设置")
config = {
'host': 'example.com',
'port': 8080,
'username': 'admin',
'password': 'secret123'
}
setup_connection(**config)5. 实际应用场景
5.1 装饰器
*args和**kwargs在装饰器中非常有用，可以让装饰器适用于任何函数。
def timing_decorator(func):
import time
def wrapper(*args, **kwargs):
start_time = time.time()
result = func(*args, **kwargs)
end_time = time.time()
print(f"函数 {func.__name__} 执行时间: {end_time - start_time:.4f}秒")
return result
return wrapper
@timing_decorator
def calculate_sum(n):
return sum(range(n+1))
calculate_sum(1000000)5.2 继承与重写方法
在面向对象编程中，*args和**kwargs可以让我们更灵活地处理父类方法的参数。
class Animal:
def __init__(self, name, **kwargs):
self.name = name
for key, value in kwargs.items():
setattr(self, key, value)
class Dog(Animal):
def __init__(self, breed, **kwargs):
super().__init__(**kwargs)
self.breed = breed
my_dog = Dog(name='Buddy', age=3, breed='金毛', color='金色')
print(vars(my_dog)) # 输出: {'name': 'Buddy', 'age': 3, 'breed': '金毛', 'color': '金色'}5.3 API包装器
在创建API包装器时，**kwargs特别有用，可以方便地处理各种可选参数。
def query_api(endpoint, **params):
import requests
base_url = "https://api.example.com/"
url = base_url + endpoint
response = requests.get(url, params=params)
return response.json()
# 使用示例
result = query_api('users', page=2, per_page=10, sort='name', filter='active')6. 注意事项
-
命名约定：虽然可以使用任何名称（如
*vars或**kvars），但*args和**kwargs是Python社区的约定俗成，建议遵循。 -
参数顺序：在函数定义中，参数必须按照以下顺序排列：
-
常规参数
-
*args -
关键字参数
-
**kwargs
-
-
避免滥用：虽然
*args和**kwargs很强大，但过度使用会降低代码的可读性。在参数数量和类型明确的情况下，最好使用明确的参数名。 -
类型提示：在Python 3中，可以使用类型提示来注明
*args和**kwargs的类型：from typing import Any def func(*args: Any, **kwargs: Any) -> None: pass
7. 总结
*args和**kwargs是Python中处理可变数量参数的强大工具：
-
*args：收集任意数量的位置参数到元组中 -
**kwargs：收集任意数量的关键字参数到字典中 -
它们可以单独使用，也可以组合使用
-
在函数调用时，
*和**可以用于解包序列和字典 -
常见应用场景包括装饰器、继承、API包装等
掌握这些技术将使你的Python函数更加灵活和强大，能够处理各种复杂的参数传递场景。