python 3.8+中/是仅限位置参数分隔符,其左侧参数必须位置传入、不可关键字;右侧参数可选位置或关键字,*后参数强制关键字。

Python 3.8 中 / 的作用是明确分隔仅限位置参数
在 Python 3.8+,函数定义里出现的 / 不是除法符号,而是语法分隔符:它左边的所有参数必须以位置方式传入,不能用关键字形式。这是 PEP 570 引入的特性,用于增强 API 稳定性和向后兼容性——比如当你要重构内部参数名,又不想破坏调用方代码时。
怎么写一个带仅限位置参数的函数
把 / 放在参数列表中你希望“截止位置参数”的位置。它前面的参数全为仅限位置参数;后面的参数可选位置或关键字;* 后面的则强制为仅限关键字参数(如果存在)。
例如:
def calc(a, b, /, c, *, d):
return (a + b) * c + d
合法调用:
-
calc(1, 2, 3, d=4)✅ ——a,b是位置参数;c可位置可关键字;d必须关键字 -
calc(1, 2, c=3, d=4)✅ ——c虽在/右边,但未被*限制,所以允许关键字
非法调用:
-
calc(a=1, b=2, c=3, d=4)❌ ——a和b出现在/左边,不能用关键字 -
calc(1, 2, 3, 4)❌ ——d在*后,必须显式写成d=4
常见误用和容易踩的坑
/ 本身不是参数,不能加类型注解,也不能出现在 *args 或 **kwargs 前后;它只起分隔作用。下面这些写法都会报 SyntaxError:
-
def f(x: int /): ...——/不能带注解 -
def f(/, x): ...——/不能放在最开头(除非函数无任何位置参数,这没意义) -
def f(x, /, *args, y): ...——/和*之间不能有*args;正确写法是def f(x, /, *args, y):实际上也非法,应改为def f(x, /, *args, y):→ 错,正确是def f(x, /, *args, y):仍错;真正合法的是def f(x, /, *args, y):?不,*args会吞掉所有剩余位置参数,导致y无法被位置传入,所以若需y为仅限关键字,得写成def f(x, /, *args, y):—— 实际上 Python 允许,但语义上y确实变成仅限关键字了,不过要注意*args后不能再有普通参数(除非用*显式分隔)
更稳妥的做法是:只在明确需要锁定前几个参数行为时使用 /,比如封装 C 扩展、对接底层协议、或设计稳定公共 API。日常写业务逻辑函数,别为了“炫技”硬加 /。
检查函数签名是否生效的快捷方法
用 help() 或 inspect.signature() 能直接看到 / 是否被识别:
import inspect sig = inspect.signature(calc) print(sig) # 输出:(a, b, /, c, *, d)
如果输出里没显示 /,说明你的 Python 版本低于 3.8,或者函数定义语法有误(比如漏了逗号、空格干扰等)。注意:IPython/Jupyter 有时会美化签名,建议用原生 Python 解释器验证。
真正难调试的是隐式依赖——比如某个库函数内部用了 /,而你试图用关键字传前几个参数,结果抛出 TypeError: function() got some positional-only arguments passed as keyword arguments。这时候别急着改调用,先查文档或源码,确认哪些参数在 / 左边。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











