如何强制Python程序用户按指定顺序传递函数参数？

针对你需要确保var1始终作为第一个参数、var2作为第二个参数传入calculate()函数的需求，有几种在函数签名层面实现约束的方法，从根源上减少参数传反的风险：

1. 使用强制关键字参数 #

在函数参数列表中加入*，*之后的参数必须通过关键字传递，彻底避免位置传参导致的顺序错误。这样调用者必须明确指定var1=和var2=，从调用语法上强制区分两个参数：

def calculate(*, var1: int, var2: int) -> bool:
    return var1 < var2

# 正确调用（必须用关键字传参）
result = calculate(var1=5, var2=10)
print(result)  # 输出 True

# 错误调用（位置传参直接报错）
# calculate(5, 10)  # 会触发 TypeError: calculate() takes 0 positional arguments but 2 were given

# 即使不小心写反参数名，也能通过参数名快速发现问题
# calculate(var2=5, var1=10)  # 逻辑错误，但参数名明确，排查成本更低

2. 自定义区分参数类型（配合静态类型检查） #

给var1和var2定义不同的自定义类型，借助静态类型检查工具（如mypy）在开发阶段拦截参数传反的问题。这种方法不会影响运行时，但能提前在编码阶段发现错误：

from typing import NewType

# 定义两个语义不同的类型，本质都是int，但静态检查会区分
Var1 = NewType('Var1', int)
Var2 = NewType('Var2', int)

def calculate(var1: Var1, var2: Var2) -> bool:
    return var1 < var2

# 正确调用：先将值转换为对应类型
value1 = Var1(5)
value2 = Var2(10)
print(calculate(value1, value2))  # 输出 True

# 错误调用（传反类型）：mypy会提示类型不匹配
# print(calculate(value2, value1))  # 静态检查报错：Argument 1 has incompatible type "Var2"; expected "Var1"

3. 运行时参数校验（可选补充） #

如果需要在运行时进一步确保逻辑正确性，可以在函数内部添加校验逻辑（比如结合业务规则），但这种方法不属于函数签名层面的约束，更适合作为兜底：

def calculate(var1: int, var2: int) -> bool:
    # 这里可以根据实际业务规则添加校验，比如API返回值的特征
    # 示例：假设var1来自API A，var2来自API B，可通过额外标识校验
    return var1 < var2

总结 #

• 优先推荐强制关键字参数，它在运行时直接阻止错误的位置传参，调用语法清晰，无需额外工具。
• 如果项目使用静态类型检查，自定义类型能在开发阶段提前拦截问题，更适合大型项目。

内容的提问来源于stack exchange，提问作者user21190291