背景#

Python以其灵活性著称，这种特性在函数参数设计中尤为明显。本文将依据语言规范，系统阐述Python函数所支持的全部参数类型及其应用

小编环境#

1
import sys
2

3
print('python 版本：',sys.version.split('|')[0])
4
#python 版本： 3.11.11

完整函数参数示例1#

1
def func(pos_only=None, /, pos_kw=None, *, kw_only=None):

仅位置参数 (Positional-only) ： / 前面的参数标识：使用 / 符号分隔特点：只能通过位置传递，不能使用参数名

1
def func(a, b, /, c):
2
    # a, b 是仅位置参数
3
    pass
4

5
# 正确调用
6
func(1, 2, 3)      # a=1, b=2, c=3
7
func(1, 2, c=3)    # a=1, b=2, c=3
8

9
# 错误调用
10
func(a=1, b=2, c=3)  # TypeError: 不能使用关键字传递a, b

位置或关键字参数 (Positional-or-keyword)： / 和 * 之间的参数位置：在 / 之后，* 之前（如果没有 / 或 *，则在所有参数中）特点：既可以通过位置传递，也可以通过关键字传递

1
def func(a, b, c):
2
    # 传统写法，所有参数都是位置或关键字参数
3
    pass
4

5
# 两种方式都可以
6
func(1, 2, 3)       # 位置传递
7
func(a=1, b=2, c=3) # 关键字传递
8
func(1, b=2, c=3)   # 混合传递

仅关键字参数 (Keyword-only)：* 后面的参数标识：使用 * 符号分隔，或者单个 * 特点：必须使用关键字传递

1
def func(*, a, b):
2
    # a, b 是仅关键字参数
3
    pass
4

5
# 正确调用
6
func(a=1, b=2)
7

8
# 错误调用
9
func(1, 2)  # TypeError: 必须使用关键字参数

完整函数参数示例2#

1
def comprehensive(
2
    pos_only_1,          # 仅位置参数
3
    pos_only_2=10,       # 带默认值的仅位置参数
4
    /,                   # 分隔符
5
    pos_kw_1,            # 位置或关键字参数
6
    pos_kw_2=20,         # 带默认值的位置或关键字参数
7
    *args,               # 可变位置参数
8
    kw_only_1,           # 仅关键字参数
9
    kw_only_2=30,        # 带默认值的仅关键字参数
10
    **kwargs             # 可变关键字参数
11
):
12
    pass
13

14
# 调用示例
15
comprehensive(
16
    1,              # pos_only_1
17
    2,              # pos_only_2
18
    3,              # pos_kw_1
19
    pos_kw_2=4,     # pos_kw_2
20
    5, 6,           # 进入args
21
    kw_only_1=7,    # kw_only_1
22
    kw_only_2=8,    # kw_only_2
23
    extra1=9,       # 进入kwargs
24
    extra2=10       # 进入kwargs
25
)

可变位置参数：*args

1
def func(a, *args, b=10):
2
    # args收集所有额外的位置参数
3
    pass
4

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

可变关键字参数： **kwargs

1
def func(a, **kwargs):
2
    # kwargs收集所有额外的关键字参数
3
    pass
4

5
func(1, x=2, y=3)  # a=1, kwargs={'x':2, 'y':3}

历史相关文章#

以上是自己实践中遇到的一些问题，分享出来供大家参考学习，欢迎关注微信公众号：DataShare ，不定期分享干货