*args 和 **kwargs 的作用与区别

答案:args和kwargs提供灵活参数处理,args收集位置参数为元组,kwargs收集关键字参数为字典,适用于通用函数、装饰器、参数解包等场景,提升代码灵活性。

*args 和 **kwargs 的作用与区别

*args

**kwargs

是 Python 中处理函数可变参数的两个核心机制。简单来说,

*args

允许你向函数传递任意数量的位置参数,它们会被收集成一个元组;而

**kwargs

则允许你传递任意数量的关键字参数,它们会被收集成一个字典。这俩玩意儿让函数的灵活性直接上了一个台阶,你不需要提前知道调用者会给你多少个参数。

解决方案

在我看来,Python 的

*args

**kwargs

简直是函数设计者的“瑞士军刀”,尤其是在需要构建通用或高度灵活的函数时。它们的核心作用就是提供了一种优雅的方式来处理那些在函数定义时,你无法确定具体数量的参数。

*`args` 的妙用**

当你定义一个函数,但又不确定调用者会传入多少个非关键字参数时,

*args

就派上用场了。它会把所有传入的、未被显式匹配的位置参数“打包”成一个元组。

比如说,你想写一个函数,可以计算任意多个数字的和:

def calculate_sum(*numbers):    total = 0    for num in numbers:        total += num    return totalprint(calculate_sum(1, 2, 3))         # 输出: 6print(calculate_sum(10, 20, 30, 40))  # 输出: 100print(calculate_sum())                # 输出: 0

你看,

*numbers

在这里就扮演了一个收集器的角色。调用的时候,你可以传三个数,也可以传四个,甚至不传,函数都能正常工作。我个人觉得,

*args

最妙的地方在于它提供了一种优雅的方式,来处理那些“我不知道你会给我多少个”的参数场景,特别适合像日志记录、数据聚合这类操作。

`kwargs` 的魔法**

**kwargs

呢,它处理的是关键字参数。当你的函数可能需要接收一些可选的、具名的配置参数,但你又不希望把所有可能的参数都列在函数签名里时,

**kwargs

就是你的救星。它会将所有未被显式匹配的关键字参数“打包”成一个字典。

想象一下,你正在写一个配置生成器函数:

def create_config(name, version="1.0", **options):    config = {        "name": name,        "version": version    }    config.update(options) # 将所有额外选项添加到配置中    return configprint(create_config("MyApp", debug_mode=True, log_level="INFO"))# 输出: {'name': 'MyApp', 'version': '1.0', 'debug_mode': True, 'log_level': 'INFO'}print(create_config("AnotherApp", version="2.0", timeout=300))# 输出: {'name': 'AnotherApp', 'version': '2.0', 'timeout': 300}

这里,

**options

收集了

debug_mode

,

log_level

,

timeout

这些关键字参数,并将它们放进了一个字典里。

**kwargs

就像是给你的函数开了一个“VIP通道”,你爱传什么配置就传什么,我都能收着,然后统一处理。这种模式在构建像 API 客户端、ORM 查询器这类需要高度可配置性的工具时,简直是神器。

两者结合与参数解包

当然,

*args

**kwargs

可以同时使用。但要记住一个顺序:*普通参数 -> `args

->

kwargs`

def process_data(prefix, *items, suffix="END", **metadata):    print(f"Prefix: {prefix}")    print(f"Items: {items}")    print(f"Suffix: {suffix}")    print(f"Metadata: {metadata}")process_data("START", 1, 2, 3, key1="value1", key2="value2")# Prefix: START# Items: (1, 2, 3)# Suffix: END# Metadata: {'key1': 'value1', 'key2': 'value2'}

除了收集参数,它们还有另一个同样重要的功能:参数解包 (Unpacking)。你可以用

*

来解包一个可迭代对象(如列表或元组),将其元素作为独立的位置参数传递;用

**

来解包一个字典,将其键值对作为独立的关键字参数传递。

my_list = [10, 20, 30]my_dict = {"city": "New York", "country": "USA"}def display_info(a, b, c, city, country):    print(f"Numbers: {a}, {b}, {c}")    print(f"Location: {city}, {country}")# 解包列表和字典display_info(*my_list, **my_dict)# Numbers: 10, 20, 30# Location: New York, USA

这个解包操作,我觉得是真正把灵活性推到极致的地方。它让函数调用者能够以一种非常动态的方式来组织和传递参数,无论是从一个列表,还是从一个配置字典里。

在哪些实际场景中,

*args

**kwargs

能发挥最大价值?

当我们在写 Python 代码时,总会遇到一些需要函数具备高度适应性的情况。在我看来,

*args

**kwargs

在以下几个场景中,简直是不可或缺的利器:

1. 构建通用型工具函数

设想你需要一个日志记录函数,它可能需要记录一条简单的消息,也可能需要记录多条消息,甚至带上一些额外的上下文信息。如果每次都为不同数量的参数定义不同的函数,那代码会变得非常臃肿。

import datetimedef log_message(level, *messages, **context):    timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")    log_entry = f"[{timestamp}] [{level.upper()}] "    # 收集并连接所有消息    log_entry += " ".join(str(msg) for msg in messages)    # 添加上下文信息    if context:        log_entry += " | " + ", ".join(f"{k}={v}" for k, v in context.items())    print(log_entry)log_message("INFO", "User logged in.", user_id=123, ip_address="192.168.1.1")log_message("WARNING", "Database connection lost!")log_message("DEBUG", "Processing item", 42, "with status", "SUCCESS")

你看,这个

log_message

函数通过

*messages

**context

,可以灵活地处理不同数量的消息和任意的上下文信息,而不需要为每种日志类型都写一个独立的函数。

2. 装饰器 (Decorators) 的基石

装饰器是 Python 中一个非常强大的元编程特性,它允许你在不修改原函数代码的情况下,给函数添加额外的功能。而要实现一个通用的装饰器,能够包装任何参数签名的函数,

*args

**kwargs

是必不可少的。

import timedef timer_decorator(func):    def wrapper(*args, **kwargs): # 使用 *args, **kwargs 捕获被装饰函数的所有参数        start_time = time.time()        result = func(*args, **kwargs) # 将捕获的参数原封不动地传给原函数        end_time = time.time()        print(f"'{func.__name__}' executed in {end_time - start_time:.4f} seconds.")        return result    return wrapper@timer_decoratordef complex_calculation(a, b, c):    time.sleep(0.5)    return a + b + c@timer_decoratordef simple_greeting(name):    time.sleep(0.1)    return f"Hello, {name}!"complex_calculation(1, 2, 3)simple_greeting("Alice")

这里,

wrapper

函数必须能够接受任何

func

可能接收的参数,所以

*args

**kwargs

是唯一的选择。它们确保了装饰器可以通用地应用于各种函数。

3. 构建代理或转发函数

有时,你可能需要创建一个函数,它本身不执行太多逻辑,而是把所有接收到的参数原封不动地传递给另一个函数或方法。这在构建 API 封装、ORM 查询接口或者简单地重构代码时非常有用。

import requestsclass APIClient:    def __init__(self, base_url):        self.base_url = base_url    def get(self, endpoint, **kwargs): # 收集所有关键字参数        url = f"{self.base_url}/{endpoint}"        print(f"Making GET request to: {url} with params: {kwargs}")        response = requests.get(url, **kwargs) # 将参数转发给 requests.get        response.raise_for_status()        return response.json()client = APIClient("https://api.example.com")# 假设 api.example.com/users?id=123&name=Alice 有数据# client.get("users", params={"id": 123, "name": "Alice"})# client.get("products", headers={"Authorization": "Bearer token"}, timeout=5)

在这个

APIClient

get

方法中,

**kwargs

收集了所有额外的参数(比如

params

,

headers

,

timeout

等),然后直接解包传递给

requests.get

。这使得

APIClient

能够非常灵活地代理

requests

库的功能。

使用

*args

**kwargs

时有哪些常见的误区或需要注意的地方?

虽然

*args

**kwargs

提供了巨大的灵活性,但如果使用不当,也可能引入一些问题。作为开发者,我们得清楚这些“坑”在哪里,才能更好地驾驭它们。

1. 可读性与可维护性下降

这是我个人觉得最需要警惕的一点。当一个函数签名里只有

(*args, **kwargs)

时,调用者很难一眼看出这个函数到底期望接收哪些参数,或者哪些参数是必须的,哪些是可选的。这就像一个黑箱,虽然灵活,但给使用者带来了困惑。

def mysterious_function(*args, **kwargs):    # ... 里面可能处理各种参数,但外部无法得知    pass# 调用时,我不知道该传什么!mysterious_function(1, 2, name="Alice", age=30)

建议: 尽量只在真正需要高度灵活性的场景下使用它们。对于那些有明确、固定参数的函数,还是老老实实地列出参数名,这样代码的可读性会好很多。如果必须使用,可以考虑在文档字符串(docstring)中详细说明

*args

**kwargs

预期接收的参数类型和作用。

2. 参数顺序问题

在函数定义中,参数的顺序是有严格要求的:*普通位置参数 -> 默认值参数 -> `args

-> 关键字参数 ->

kwargs`。如果顺序错了,Python 解释器会报错。

# 错误示例:*args 放在了普通参数之前# def func(*args, a, b):#     pass# 错误示例:**kwargs 放在了 *args 之前# def func(a, **kwargs, *args):#     pass# 正确顺序def func(a, b=1, *args, c, **kwargs): # 注意这里的 c 是一个强制关键字参数    print(f"a={a}, b={b}, args={args}, c={c}, kwargs={kwargs}")func(10, 20, 30, 40, c=50, key1="value1")# a=10, b=20, args=(30, 40), c=50, kwargs={'key1': 'value1'}

这个顺序问题,我刚开始学的时候也犯过几次错,被 Python 解释器无情地教育了。记住这个“口诀”就能避免大部分问题。

3. 参数解包时的类型不匹配

使用

*

**

进行参数解包时,要确保你解包的数据类型是正确的。

*

只能解包可迭代对象(如列表、元组、字符串),将其元素作为位置参数;

**

只能解包字典,将其键值对作为关键字参数。

def my_printer(a, b, c):    print(a, b, c)data_list = [1, 2, 3]data_dict = {"a": 1, "b": 2, "c": 3}my_printer(*data_list) # 正确# my_printer(**data_list) # 错误:列表不能用 ** 解包my_printer(**data_dict) # 正确# my_printer(*data_dict) # 正确,但解包的是字典的键,而不是值

这种类型不匹配的错误,通常会在运行时暴露出来,导致

TypeError

。所以,在解包前最好确认一下数据结构。

4. 命名约定

虽然你可以给它们起任何名字,比如

*args_list

**config_dict

,但 Python 社区约定俗成的做法是使用

*args

**kwargs

。遵循这个约定能极大地提高代码的可读性和团队协作效率。我个人觉得,这种约定比强制规定更有效,因为它建立了一种无声的共识。

5. 性能考量(通常可忽略)

理论上,收集和解包参数会引入微小的运行时开销,因为 Python 需要创建元组或字典来存储这些参数。但在绝大多数实际应用中,这种开销是微不足道的,几乎可以忽略不计。我个人从没因为

*args

**kwargs

的性能问题而重构过代码。除非你正在编写一个对毫秒级性能有极致要求的底层库,否则不必为此过度担忧。

除了函数定义和调用,

*args

**kwargs

在 Python 生态中还有哪些进阶应用?

*args

**kwargs

的影响力远不止于普通的函数定义和调用。它们渗透在 Python 的许多高级特性和设计模式中,是构建灵活、可扩展代码的关键。

*1. 继承中的参数传递:`super().init(args, kwargs)`

面向对象编程中,当子类重写父类的

__init__

方法时,通常需要调用父类的

__init__

来初始化父类的部分。这时,

*args

**kwargs

就显得尤为重要,它们确保了子类能够无缝地将所有构造参数传递给父类,而无需子类知道父类具体需要哪些参数。

class Parent:    def __init__(self, name, age, **kwargs):        self.name = name        self.age = age        print(f"Parent initialized: {name}, {age}, extra: {kwargs}")class Child(Parent):    def __init__(self, name, age, hobby, *args, **kwargs):        super().__init__(name, age, **kwargs) # 将 kwargs 传递给父类        self.hobby = hobby        print(f"Child initialized with hobby: {hobby}, args: {args}")# Child 知道自己需要 name, age, hobby,但额外的参数可以交给 Parent 处理c = Child("Alice", 10, "reading", favorite_color="blue", school="ABC")# Parent initialized: Alice, 10, extra: {'favorite_color': 'blue', 'school': 'ABC'}# Child initialized with hobby: reading, args: ()

这种模式非常常见,它让继承链上的类能够各自处理自己关心的参数,同时又保持了良好的协作性。

2.

functools.partial

的灵活组合

functools.partial

是一个非常酷的工具,它允许你“部分应用”一个函数,也就是固定函数的一些参数,创建一个新的函数。而新的函数仍然可以通过

*args

**kwargs

来接受剩余的参数。

from functools import partialdef greet(greeting_word, name, punctuation="!"):    return f"{greeting_word}, {name}{punctuation}"# 创建一个总是说 "Hello" 的函数say_hello = partial(greet, "Hello")print(say_hello("Bob"))             # 输出: Hello, Bob!print(say_hello("Charlie", "???"))  # 输出: Hello, Charlie???# 创建一个总是说 "Hi" 且带感叹号的函数say_hi_exclam = partial(greet, "Hi", punctuation="!!!")print(say_hi_exclam("David"))       # 输出: Hi, David!!!
partial

内部其实就是利用了

*args

**kwargs

来接收原始函数未被固定的参数,这使得它在创建高度定制化的回调函数或事件处理器时非常有用。

3. 元编程 (Metaclasses) 与类动态创建

在 Python 的元编程领域,

*args

**kwargs

更是不可或缺。当你需要动态地创建类,或者通过元类来修改类的行为时,它们被用来捕获传递给类构造函数(即

type()

或元类的

__new__

方法)的参数。

# 这是一个简化的例子,元编程通常更复杂def create_my_class(name, bases, attrs, **kwargs):    print(f"Creating class '{name}' with bases {bases}, attrs {attrs}, and extra: {kwargs}")    # 可以在这里根据 kwargs 修改 attrs 或 bases    return type(name, bases, attrs)# 动态创建一个类,并传递额外的关键字参数MyDynamicClass = create_my_class("MyDynamicClass", (object,), {"value": 10}, version="1.0", author="Me")print(MyDynamicClass.value) # 输出: 10

虽然这个例子只是模拟了

type()

的行为,但它展示了

**kwargs

如何在类创建级别捕获并处理额外的元数据。在更复杂的元类中,

*args

**kwargs

允许元类接收并处理所有传递给类定义的参数,从而实现更强大的类定制能力。这部分内容确实有点深,但它揭示了

*args

**kwargs

在 Python 语言底层机制中的重要性。

以上就是*args 和 **kwargs 的作用与区别的详细内容,更多请关注php中文网其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1370272.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月14日 10:24:04
下一篇 2025年12月14日 10:24:13

相关推荐

  • Uniapp 中如何不拉伸不裁剪地展示图片?

    灵活展示图片:如何不拉伸不裁剪 在界面设计中,常常需要以原尺寸展示用户上传的图片。本文将介绍一种在 uniapp 框架中实现该功能的简单方法。 对于不同尺寸的图片,可以采用以下处理方式: 极端宽高比:撑满屏幕宽度或高度,再等比缩放居中。非极端宽高比:居中显示,若能撑满则撑满。 然而,如果需要不拉伸不…

    2025年12月24日
    400
  • 如何让小说网站控制台显示乱码,同时网页内容正常显示?

    如何在不影响用户界面的情况下实现控制台乱码? 当在小说网站上下载小说时,大家可能会遇到一个问题:网站上的文本在网页内正常显示,但是在控制台中却是乱码。如何实现此类操作,从而在不影响用户界面(UI)的情况下保持控制台乱码呢? 答案在于使用自定义字体。网站可以通过在服务器端配置自定义字体,并通过在客户端…

    2025年12月24日
    800
  • SASS 中的 Mixins

    mixin 是 css 预处理器提供的工具,虽然它们不是可以被理解的函数,但它们的主要用途是重用代码。 不止一次,我们需要创建多个类来执行相同的操作,但更改单个值,例如字体大小的多个类。 .fs-10 { font-size: 10px;}.fs-20 { font-size: 20px;}.fs-…

    2025年12月24日
    000
  • 如何在地图上轻松创建气泡信息框?

    地图上气泡信息框的巧妙生成 地图上气泡信息框是一种常用的交互功能,它简便易用,能够为用户提供额外信息。本文将探讨如何借助地图库的功能轻松创建这一功能。 利用地图库的原生功能 大多数地图库,如高德地图,都提供了现成的信息窗体和右键菜单功能。这些功能可以通过以下途径实现: 高德地图 JS API 参考文…

    2025年12月24日
    400
  • 如何使用 scroll-behavior 属性实现元素scrollLeft变化时的平滑动画?

    如何实现元素scrollleft变化时的平滑动画效果? 在许多网页应用中,滚动容器的水平滚动条(scrollleft)需要频繁使用。为了让滚动动作更加自然,你希望给scrollleft的变化添加动画效果。 解决方案:scroll-behavior 属性 要实现scrollleft变化时的平滑动画效果…

    2025年12月24日
    000
  • 如何为滚动元素添加平滑过渡,使滚动条滑动时更自然流畅?

    给滚动元素平滑过渡 如何在滚动条属性(scrollleft)发生改变时为元素添加平滑的过渡效果? 解决方案:scroll-behavior 属性 为滚动容器设置 scroll-behavior 属性可以实现平滑滚动。 html 代码: click the button to slide right!…

    2025年12月24日
    500
  • 如何选择元素个数不固定的指定类名子元素?

    灵活选择元素个数不固定的指定类名子元素 在网页布局中,有时需要选择特定类名的子元素,但这些元素的数量并不固定。例如,下面这段 html 代码中,activebar 和 item 元素的数量均不固定: *n *n 如果需要选择第一个 item元素,可以使用 css 选择器 :nth-child()。该…

    2025年12月24日
    200
  • 使用 SVG 如何实现自定义宽度、间距和半径的虚线边框?

    使用 svg 实现自定义虚线边框 如何实现一个具有自定义宽度、间距和半径的虚线边框是一个常见的前端开发问题。传统的解决方案通常涉及使用 border-image 引入切片图片,但是这种方法存在引入外部资源、性能低下的缺点。 为了避免上述问题,可以使用 svg(可缩放矢量图形)来创建纯代码实现。一种方…

    2025年12月24日
    100
  • 如何解决本地图片在使用 mask JS 库时出现的跨域错误?

    如何跨越localhost使用本地图片? 问题: 在本地使用mask js库时,引入本地图片会报跨域错误。 解决方案: 要解决此问题,需要使用本地服务器启动文件,以http或https协议访问图片,而不是使用file://协议。例如: python -m http.server 8000 然后,可以…

    2025年12月24日
    200
  • 如何让“元素跟随文本高度,而不是撑高父容器?

    如何让 元素跟随文本高度,而不是撑高父容器 在页面布局中,经常遇到父容器高度被子元素撑开的问题。在图例所示的案例中,父容器被较高的图片撑开,而文本的高度没有被考虑。本问答将提供纯css解决方案,让图片跟随文本高度,确保父容器的高度不会被图片影响。 解决方法 为了解决这个问题,需要将图片从文档流中脱离…

    2025年12月24日
    000
  • 为什么 CSS mask 属性未请求指定图片?

    解决 css mask 属性未请求图片的问题 在使用 css mask 属性时,指定了图片地址,但网络面板显示未请求获取该图片,这可能是由于浏览器兼容性问题造成的。 问题 如下代码所示: 立即学习“前端免费学习笔记(深入)”; icon [data-icon=”cloud”] { –icon-cl…

    2025年12月24日
    200
  • 如何利用 CSS 选中激活标签并影响相邻元素的样式?

    如何利用 css 选中激活标签并影响相邻元素? 为了实现激活标签影响相邻元素的样式需求,可以通过 :has 选择器来实现。以下是如何具体操作: 对于激活标签相邻后的元素,可以在 css 中使用以下代码进行设置: li:has(+li.active) { border-radius: 0 0 10px…

    2025年12月24日
    100
  • 如何模拟Windows 10 设置界面中的鼠标悬浮放大效果?

    win10设置界面的鼠标移动显示周边的样式(探照灯效果)的实现方式 在windows设置界面的鼠标悬浮效果中,光标周围会显示一个放大区域。在前端开发中,可以通过多种方式实现类似的效果。 使用css 使用css的transform和box-shadow属性。通过将transform: scale(1.…

    2025年12月24日
    200
  • 为什么我的 Safari 自定义样式表在百度页面上失效了?

    为什么在 Safari 中自定义样式表未能正常工作? 在 Safari 的偏好设置中设置自定义样式表后,您对其进行测试却发现效果不同。在您自己的网页中,样式有效,而在百度页面中却失效。 造成这种情况的原因是,第一个访问的项目使用了文件协议,可以访问本地目录中的图片文件。而第二个访问的百度使用了 ht…

    2025年12月24日
    000
  • 如何用前端实现 Windows 10 设置界面的鼠标移动探照灯效果?

    如何在前端实现 Windows 10 设置界面中的鼠标移动探照灯效果 想要在前端开发中实现 Windows 10 设置界面中类似的鼠标移动探照灯效果,可以通过以下途径: CSS 解决方案 DEMO 1: Windows 10 网格悬停效果:https://codepen.io/tr4553r7/pe…

    2025年12月24日
    000
  • 使用CSS mask属性指定图片URL时,为什么浏览器无法加载图片?

    css mask属性未能加载图片的解决方法 使用css mask属性指定图片url时,如示例中所示: mask: url(“https://api.iconify.design/mdi:apple-icloud.svg”) center / contain no-repeat; 但是,在网络面板中却…

    2025年12月24日
    000
  • 如何用CSS Paint API为网页元素添加时尚的斑马线边框?

    为元素添加时尚的斑马线边框 在网页设计中,有时我们需要添加时尚的边框来提升元素的视觉效果。其中,斑马线边框是一种既醒目又别致的设计元素。 实现斜向斑马线边框 要实现斜向斑马线间隔圆环,我们可以使用css paint api。该api提供了强大的功能,可以让我们在元素上绘制复杂的图形。 立即学习“前端…

    2025年12月24日
    000
  • 图片如何不撑高父容器?

    如何让图片不撑高父容器? 当父容器包含不同高度的子元素时,父容器的高度通常会被最高元素撑开。如果你希望父容器的高度由文本内容撑开,避免图片对其产生影响,可以通过以下 css 解决方法: 绝对定位元素: .child-image { position: absolute; top: 0; left: …

    2025年12月24日
    000
  • 为什么自定义样式表在 Safari 中访问百度页面时无法生效?

    自定义样式表在 safari 中失效的原因 用户尝试在 safari 偏好设置中添加自定义样式表,代码如下: body { background-image: url(“/users/luxury/desktop/wallhaven-o5762l.png”) !important;} 测试后发现,在…

    2025年12月24日
    000
  • 使用 Mask 导入本地图片时,如何解决跨域问题?

    跨域疑难:如何解决 mask 引入本地图片产生的跨域问题? 在使用 mask 导入本地图片时,你可能会遇到令人沮丧的跨域错误。为什么会出现跨域问题呢?让我们深入了解一下: mask 框架假设你以 http(s) 协议加载你的 html 文件,而当使用 file:// 协议打开本地文件时,就会产生跨域…

    2025年12月24日
    200

发表回复

登录后才能评论
关注微信