Python方法参数能否在声明时定义取值范围？有无更优实现方式？

Python标准的类型标注本身不支持直接指定数值的取值范围，但有几种便捷方式能实现类似"声明阶段指定范围"的效果，同时兼顾静态提示和运行时校验：

1. 用 typing.Annotated 附加元数据（配合第三方库自动校验） #

Annotated 可以给类型标注附加额外信息，搭配pydantic这类库就能实现自动的范围校验，写法接近声明式：

from typing import Annotated
from pydantic import Field, validate_call

@validate_call
def methode_range(value: Annotated[int, Field(gt=0, lt=5)]):
    print(value)

# 调用时参数不符合会自动抛出ValidationError
methode_range(6)

这里Annotated里的Field明确指定了value要大于0且小于5，加上@validate_call装饰器后，调用方法时会自动校验参数。

2. 自定义校验类型别名 #

可以创建一个专属的类型，提前做好范围校验，方法声明时直接用这个类型：

from typing import NewType

Int0To5 = NewType('Int0To5', int)

def get_int0to5(value: int) -> Int0To5:
    if not (0 < value < 5):
        raise ValueError("输入值必须在0到5之间（不包含边界）")
    return Int0To5(value)

def methode_range(value: Int0To5):
    print(value)

# 使用时先通过校验函数转换
methode_range(get_int0to5(3))

这种方式能让方法声明一眼看出参数的范围约束，同时确保传入的参数都经过校验。

3. 自定义装饰器做范围校验 #

写一个通用的范围校验装饰器，给方法加上注解就能指定参数范围：

def check_range(gt=None, lt=None):
    def decorator(func):
        def wrapper(value):
            if gt is not None and value <= gt:
                raise ValueError(f"值必须大于{gt}")
            if lt is not None and value >= lt:
                raise ValueError(f"值必须小于{lt}")
            return func(value)
        return wrapper
    return decorator

@check_range(gt=0, lt=5)
def methode_range(value: int):
    print(value)

# 调用不符合范围的参数会触发异常
methode_range(0)

装饰器让方法声明更简洁，不需要在方法内部写重复的条件判断。

需要注意的是，Python原生的类型标注仅用于静态代码提示，不会做运行时的参数校验，上述方案里，Annotated+pydantic的组合最接近"声明阶段指定范围"的需求，既能在IDE里看到范围提示，又能自动完成校验。

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