必须用 / 明确标记仅限位置参数，因其是强制接口契约而非语法糖，可防止关键字传参导致的语义歧义与兼容性断裂，如 pow(y=2, x=3) 反直觉且易因重构失效。
为什么必须用 / 明确标记仅限位置参数
Python 3.8 引入的仅限位置形参（/）不是语法糖，而是接口契约的强制声明。它能防止调用方误传关键字参数导致逻辑歧义或未来兼容性断裂。比如你设计一个数值计算函数，x 和 y 的顺序语义固定（如 pow(x, y)），若允许 pow(y=2, x=3)，不仅反直觉，还可能在后续版本中因参数重命名或重构而意外失效。
实际场景中，这类参数通常是核心输入，不参与配置或可选行为——它们就是“数据本身”，不是“选项”。
def foo(a, b, /, c=None, *, d=1) 这种混合签名怎么安排才合理
签名里的三段划分（位置-only、位置/关键字、仅关键字）不是随意分隔，而是按稳定性与语义层级组织：
-
a, b放在/前：它们是不可协商的主输入，例如parse_json(data, /, encoding='utf-8')中的data必须是第一个且只能位置传 -
c=None在/和*之间：属于“常用可选参数”，允许位置或关键字传，但默认值应稳定（避免c=[]这类可变默认值） -
d=1在*后：属于“明确意图型配置”，强制关键字传，便于文档化和 IDE 提示，也方便未来加新参数而不破坏调用
错误示范：def load(path, /, timeout=30, *, format='json') 是合理的；但若把 timeout 放到 / 前，就等于承诺“永远不允许 load('x', timeout=60)”，这通常没必要且难维护。
立即学习“Python免费学习笔记（深入）”；
哪些标准库函数已用 /，能抄作业吗
可以，而且应该参考。Python 3.8+ 中 str.replace()、int()、float()、dict.pop() 等都已启用仅限位置参数。例如：
str.replace(old, new, count, /)
这意味着 'aabb'.replace(old='a', new='c') 会直接报错 TypeError: replace() takes no keyword arguments —— 这不是 bug，是设计。你自己的 API 若有类似“操作对象 + 替换目标 + 限制次数”的三元结构，照搬这个模式几乎零风险。
注意点：
- 不要为了用
/而用：如果某个参数将来大概率要支持关键字（比如用户常需跳过中间参数只设最后一个），就别塞进/前 - 类型提示仍需显式标注：
def f(x: int, /) -> str:，否则mypy会忽略位置限制语义 -
help()和 docstring 里不会自动体现/，得手动写清楚“xmust be passed positionally”
用 inspect.signature() 检查时容易漏掉什么
运行时检查函数签名时，inspect.Parameter.kind 的值才是关键依据，而不是看源码有没有写 /。常见疏忽：
- 动态生成的函数（如用
functools.partial或装饰器包装后）可能丢失原始/信息，需用inspect.signature(f).bind_partial(...)测试绑定行为 -
Parameter.POSITIONAL_ONLY类型的参数，其default属性恒为inspect.Parameter.empty，哪怕你写了def f(x=42, /)—— 实际上 Python 不允许这种写法，会 SyntaxError，所以根本不会存在“带默认值的位置仅限参数” - 测试兼容性时，别只测 CPython：PyPy 3.8+ 支持，但某些旧版嵌入式 Python（如 MicroPython）完全不识别
/，报SyntaxError: invalid syntax
真正健壮的接口，不是靠语法炫技，而是让调用者在写错第一行时就立刻知道错在哪，而不是跑完半程才发现参数被当成了配置项。
