Python 3.8+ 中 / 表示其左侧参数仅能位置传参,* 表示其右侧参数必须关键字传参;二者可共存形成三段式参数结构:位置专用、混合、关键字专用。

Python 3.8+ 中 / 和 * 参数分隔符怎么写
必须用位置参数传参的地方,加 /;必须用关键字传参的地方,加 *。它们不是装饰器或语法糖,是函数签名里实实在在的符号,写在 def 行参数列表中。
常见错误是把 / 放错位置(比如放在第一个参数前),或误以为 * 后面还能有普通参数(其实不能,除非再跟 **kwargs)。
-
/左侧所有参数必须按位置传(不能加关键字名),右侧参数可选 -
*右侧所有参数必须用关键字传(不能只给值),左侧参数可选 -
/和*可以共存,中间那段参数既可位置也可关键字
什么时候必须用 /:兼容 C 扩展或冻结历史接口
典型场景是模拟内置函数行为,比如 len() 不允许写 len(obj=x),因为它的第一个参数是「仅位置」的。Python 标准库很多函数(如 dict.fromkeys())在 3.8+ 后也加了 / 来锁定调用方式。
你自己定义函数时加 /,主要是为了未来不被破坏性改动影响——比如某天你想把参数名从 data 改成 seq,但已有代码全用位置调用,那就完全不影响。
def calc(a, b, /, c, d):
return (a + b) * (c + d)
calc(1, 2, 3, 4) # ✅ 正确
calc(1, 2, c=3, d=4) # ✅ 正确(c、d 是可选关键字)
calc(a=1, b=2, c=3, d=4) # ❌ TypeError: calc() got some positional-only arguments passed as keyword arguments: 'a, b'
什么时候必须用 *:强制显式命名关键配置项
当某个参数语义重要、容易被忽略或顺序易混淆时,用 * 能逼调用者写清楚意图。比如一个绘图函数,color 和 alpha 都是数值,但混着传极易出错。
注意:* 后面如果没参数,就只是禁止接收额外的位置参数(类似 def f(a, *, b=None):);如果有参数,那它们全是强制关键字。
def plot(x, y, *, color='blue', alpha=1.0, linewidth=1):
...
plot([1,2], [3,4], 'red', 0.5) # ❌ TypeError: plot() takes 2 positional arguments but 4 were given
plot([1,2], [3,4], color='red', alpha=0.5) # ✅ 正确
/ 和 * 共存时的参数分区逻辑
三段式结构最常见:def f(pos_only, /, pos_or_kwd, *, kwd_only):。中间那段最灵活,但也是最容易写错调用方式的地方——它看起来像能混用,但实际取决于你传参时用不用关键字。
一个容易被忽略的点:/ 和 * 本身不占参数槽位,也不出现在 inspect.signature() 的参数对象里;它们只是分隔标记。另外,lambda 不支持这两个符号。
- 位置参数区(
/左):只能位置传,名字改了也不影响老代码 - 混合区(
/和*之间):可位置可关键字,但一旦用了关键字,后面所有同区参数都得用关键字(否则报错) - 关键字专属区(
*右):必须带名字,且不能漏掉非默认值参数
复杂点在于混合区的行为边界模糊——它不像前后两段那么绝对,需要靠调用习惯和文档共同约束。真要彻底防错,还是得靠类型检查器(如 mypy)或运行时校验。










