Python3 keyword-only 参数详解：位置与关键字传递规则

Python3 keyword-only 参数概述

Python3 对函数参数的匹配规则进行了通用化处理，引入了 keyword-only 参数概念。这类参数要求必须通过关键字方式传递，不能由位置参数填充。这一机制在处理包含多个参数的函数时尤为实用。

keyword-only

kword_only(1, 2, 3, c=4)
print('-' * 20)
kword_only(a=1, c=3)

示例结果：

1 (2, 3) 4 -------------------- 1 () 3

*args 后的 keyword-only 参数

当参数位于 *args 之后时，这些参数被定义为 keyword-only 参数。在调用函数时，必须使用关键字参数形式传递值，否则程序将抛出异常。

def kword_only(a, *b, c):
  print(a, b, c)
kword_only(1, 2, 3)

异常结果：

kword_only(1, 2, 3) TypeError: kword_only() missing 1 required keyword-only argument: 'c'

单独 * 分隔符的使用

此外，可以在参数列表中使用单独的 * 字符。这表示函数不接受可变长度的位置参数列表，而是强制要求 * 之后的所有参数都必须以关键字参数的形式传递。

def kword_only(a, *, b, c):
  print(a, b, c)
kword_only(1, b=2, c=3)
print('-'*20)
kword_only(b=2, c=3, a=1)

示例结果：

1 2 3 -------------------- 1 2 3

从示例可以看出，参数 a 可以通过位置参数传递，而参数 b 和 c 必须通过关键字参数传递。如果尝试以位置方式传递 b 或 c，将会引发异常。

def kword_only(a, *, b, c):
  print(a, b, c)
kword_only(1, 2, 3)

异常结果：

kword_only(1, 2, 3) TypeError: kword_only() takes 1 positional argument but 3 were given

keyword-only 参数的默认值设置

我们可以为 keyword-only 参数设置默认值。在此情况下，参数 a 仍可通过位置或关键字传递，而 b 和 c 变为可选参数。若需传递这些参数，依然必须使用关键字参数形式。

def kword_only(a, *, b=2, c=3):
  print(a, b, c)
kword_only(1)
print('-'*20)
kword_only(a=1)
print('-'*20)
kword_only(b=22, c=33, a=11)

示例结果：

1 2 3 -------------------- 1 2 3 -------------------- 11 22 33

总结

以上介绍了 Python 函数参数匹配模型中 keyword-only 参数的详细规则，希望能帮助读者理解并应用。如有任何疑问，欢迎留言交流，我们将及时回复。感谢大家的支持！ 若本文对您有帮助，欢迎转载，请注明出处，谢谢！