python 3.8+ 支持用 分隔符强制后续参数为关键字参数，语法层约束、调用时位置传参会直接报 typeerror；正确写法为 def f(a, , c, d=false)， 前后需加逗号，不可与 args/*kwargs 混淆。
Python中用*分隔符实现强制关键字参数
Python 3.8+ 支持在函数定义中使用单个星号 * 作为参数分隔符，其后的所有形参必须以关键字形式传入。这不是装饰器或运行时检查，而是语法层强制约束，调用时若用位置参数会直接报错 TypeError。
适用场景：当函数有多个布尔标志、可选配置或语义易混淆的参数（比如 reverse 和 case_sensitive）时，加 * 能立刻阻止误写成 sort_list(data, True, False) 这类难以维护的调用。
-
*必须出现在参数列表中普通参数之后、**kwargs之前 - 允许
*后面不接任何参数（即要求“所有后续参数都必须是关键字”，但当前没有后续参数） - 不支持在
lambda中使用*分隔符 - 类型提示中无需特殊标注，mypy 和 pyright 均能正确识别该约束
常见错误：把*误写成**或漏掉逗号
新手常把强制关键字参数写成 def f(a, **b) —— 这实际是收集多余关键字参数，完全达不到约束目的；也有人写成 def f(a, *b, c)，结果 b 变成可变位置参数，c 反而被强制关键字，逻辑错乱。
正确写法必须是 def f(a, *, c, d=False)。注意 * 是独立符号，前后都要有逗号（除非它在最开头或结尾）。如果漏掉 * 后的逗号，比如 def f(a, *c, d=False)，Python 会把 c 解析为 *args，d 成了 **kwargs 的一部分，彻底失效。
- 错误示例：
def process(x, **opts, timeout=30)→ 语法错误，**不能后置默认参数 - 错误示例：
def load(path, *encoding, errors='strict')→encoding变成*args，errors实际未被强制 - 正确调试方式：写完立刻尝试位置调用，如
f(1, 2)，应立即触发TypeError: f() takes 1 positional argument but 2 were given
与@functools.wraps结合时保留强制关键字行为
如果用装饰器包装了含 * 的函数，原始签名会被覆盖，导致 IDE 和 help() 显示错误，甚至某些静态检查工具失效。这时候必须用 @functools.wraps，且确保被包装函数本身定义规范。
例如写一个日志装饰器：
from functools import wraps
<p>def log_calls(func):
@wraps(func)
def wrapper(*args, *<em>kwargs):
print(f"Calling {func.<strong>name</strong>}")
return func(</em>args, **kwargs)
return wrapper</p><p>@log_calls
def send_request(url, <em>, timeout=5, verify=True): # ✅ 正确：</em> 在被装饰函数内
pass
</p>
若把 * 放到装饰器内部（比如 wrapper 里硬加），不仅无效，还会破坏原函数签名。关键点在于：强制关键字是函数定义时的语法属性，只能在被装饰的原始函数中声明。
- 检查是否生效：调用
send_request("http://a", False)应报错，而非静默接受 - IDE（如 VS Code + Pylance）会基于
__wrapped__链正确推导签名，前提是用了@wraps - 避免在 wrapper 中重写参数列表，那只会让类型检查器彻底迷失
兼容旧版本Python或动态场景下的替代方案
Python * 分隔符，此时无法从语法层强制。可行但稍重的替代是手动检查 len(args) 并抛出 TypeError，不过这属于运行时防御，无法被 IDE 提前发现，也绕过类型检查器。
更实用的做法是：在文档字符串和类型注解中明确标注「keyword-only」，并配合 pre-commit 钩子扫描调用点（如用 pygrep 匹配 func\(.*True.*False 这类高风险模式）。
- 不推荐用
inspect.signature在运行时做参数校验——性能开销大，且对已编译的 C 扩展函数可能失败 - 如果函数需被 pickle 或 RPC 调用，确保序列化框架（如 dill、cloudpickle）支持带
*的签名（主流均已支持） - 真正复杂的参数逻辑（比如互斥参数组）建议改用
dataclass或专用配置类，比堆砌关键字参数更清晰
强制关键字参数不是银弹，它只解决「调用时传错顺序」这一类问题。参数含义模糊、业务逻辑耦合过紧，得靠重构，不是加个 * 就能掩盖的。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
