Python 3.8中类方法的positional-only参数必须将/置于self之后、其他参数之间，self不可被标记为仅位置，且/前参数仅能位置传入、/后可混用，*后则强制关键字；例如def add(self, x, y, /, z=10, *, w=100)。
Python 3.8 中类方法怎么写 positional-only 参数
必须用 / 符号显式分隔，且只能放在参数列表中间或末尾（不能在 * 或 ** 后），类方法中和普通函数一样生效，但要注意 self 的位置。
常见错误是把 / 放在 self 前面，比如 def method(/, self, x) —— 这会直接报 SyntaxError: invalid syntax。正确写法是 self 必须作为第一个形参，positional-only 参数紧随其后。
-
self永远是第一个参数，不可省略，也不可标为 positional-only - 所有想设为仅位置传参的参数，必须放在
/左侧，且在self之后 -
/右侧的参数可以位置或关键字传入；*右侧的才强制关键字（keyword-only） - 不支持
def method(self, /, x, y, /)这种多个/—— 一个函数最多一个/
实际定义示例：带 positional-only 的类方法
下面这个例子中，x 和 y 是仅位置参数，z 可位置或关键字，w 强制关键字：
class Calc:
def add(self, x, y, /, z=10, *, w=100):
return x + y + z + w
调用时：
立即学习“Python免费学习笔记（深入）”；
-
c = Calc(); c.add(1, 2)✅ 允许（z用默认值，w用默认值） -
c.add(1, 2, 3)✅ 允许（z=3，w仍用默认） -
c.add(1, 2, z=3)✅ 允许（z改为关键字传入） -
c.add(1, 2, w=5)✅ 允许（w是 keyword-only） -
c.add(x=1, y=2)❌ 报TypeError: add() got some positional-only arguments passed as keyword arguments
为什么类方法里用 positional-only 参数？
主要是为了接口稳定性与语义清晰：比如你后续想把某个参数从“支持关键字”改成“仅位置”，又不想破坏已有调用（因为用户可能误用了关键字形式），提前设为 positional-only 能尽早暴露问题。
另一个典型场景是封装 C 扩展或仿照内置函数行为（如 str.replace(old, new, /, count)），让 Python 层接口和底层逻辑对齐。
- 参数名未来可能重命名（比如从
axis改成dim），但位置不变 —— positional-only 避免用户依赖旧参数名 - 避免用户混淆同义参数（如
inplace=Truevsmutate=True），干脆不给关键字名 - CPython 内部大量使用（
dict.pop(key, /, default)），学它不是为了炫技，而是减少歧义
容易忽略的兼容性细节
Python 3.8+ 才支持 / 语法，低于 3.8 会直接 SyntaxError；而且类型检查工具（如 mypy）直到 0.930+ 才完整支持 positional-only 标注，旧版可能报错或静默忽略。
- 类型注解要写成
def method(self, x: int, y: str, /, z: float = ...)，mypy 0.930+ 才能正确校验 - docstring 里别写
:param x:这种，因为x不接受关键字传入；建议注明 “(positional-only)” -
inspect.signature()能识别/，但旧版 IDE（如 PyCharm 2020.1 之前）可能无法正确渲染参数提示 - 如果方法被装饰（如
@classmethod或自定义装饰器），确保装饰器不修改签名，否则/可能失效
最常被跳过的点：没检查运行环境 Python 版本就提交代码，CI 上直接挂掉 —— 务必在 pyproject.toml 或 setup.py 里锁死 python_requires=">=3.8"。
