能否在Python中实现类似TypeScript的parameter decorators？

TypeScript支持直接给函数/方法参数添加装饰器（比如@required、@User()），用来给参数附加元数据或实现参数级别的逻辑处理。Python 3.11及当前稳定版本没有原生的参数装饰器语法，也暂无相关PEP提案，但可以通过方法装饰器+参数元数据标记的组合，或者元类来实现类似效果，核心是给目标参数绑定元数据，再在方法执行时解析并应用这些元数据。

方案一：参数标记器+方法装饰器（最常用） #

先定义一个用来标记参数的“标记器”（本质是给参数绑定元数据的函数），再配合一个方法装饰器读取这些标记并处理业务逻辑。

示例1：实现类似@required的参数必填校验 #

# 定义参数标记器，标记参数为必填项
def required(param_name: str):
    return {"type": "required", "param": param_name}

# 方法装饰器，解析参数标记并执行校验逻辑
def validate_params(func):
    def wrapper(*args, **kwargs):
        import inspect
        sig = inspect.signature(func)
        params = sig.parameters

        # 遍历所有参数，检查是否存在必填标记
        for name, param in params.items():
            if isinstance(param.default, dict) and param.default.get("type") == "required":
                # 校验参数是否被传入（位置参数或关键字参数）
                if name not in kwargs and (len(args) <= list(params.keys()).index(name)):
                    raise ValueError(f"参数 {name} 为必填项")
        return func(*args, **kwargs)
    return wrapper

# 使用示例
class BugReport:
    @validate_params
    def print(self, verbose=required("verbose")):
        print(f"打印报告，详细模式：{verbose}")

# 测试执行
report = BugReport()
report.print(True)  # 正常输出：打印报告，详细模式：True
# report.print()      # 抛出异常：ValueError: 参数 verbose 为必填项

示例2：实现类似NestJS@User()的参数注入 #

# 模拟请求上下文（实际场景可替换为框架的请求对象）
request_context = {"user": {"id": 1, "name": "张三"}}

# 参数标记器，标记需要注入用户信息的参数
def User():
    return {"type": "user_inject"}

# 方法装饰器，处理参数注入逻辑
def inject_params(func):
    def wrapper(*args, **kwargs):
        import inspect
        sig = inspect.signature(func)
        bound_args = sig.bind(*args, **kwargs).arguments

        # 遍历参数，检查是否存在用户注入标记
        for name, param in sig.parameters.items():
            if isinstance(param.default, dict) and param.default.get("type") == "user_inject":
                # 从上下文注入用户数据
                bound_args[name] = request_context["user"]
        
        # 重新组装参数并调用原函数
        return func(*bound_args.values())
    return wrapper

# 使用示例
class SomeController:
    @inject_params
    async def find_one(self, user=User()):
        print(f"当前用户：{user}")

# 测试执行
controller = SomeController()
import asyncio
asyncio.run(controller.find_one())  # 输出：当前用户：{'id': 1, 'name': '张三'}

方案二：使用元类统一处理类中方法 #

如果需要给整个类的所有方法统一处理参数装饰器，可以用元类自动为类中的方法添加参数解析逻辑，避免每个方法手动绑定装饰器。

# 复用之前定义的User标记器和inject_params装饰器
class ParamDecoratorMeta(type):
    def __new__(cls, name, bases, attrs):
        # 遍历类中所有非内置方法
        for attr_name, attr_value in attrs.items():
            if callable(attr_value) and not attr_name.startswith("__"):
                # 自动为方法添加参数注入装饰器
                attrs[attr_name] = inject_params(attr_value)
        return super().__new__(cls, name, bases, attrs)

# 使用元类的控制器类
class SomeController(metaclass=ParamDecoratorMeta):
    async def find_one(self, user=User()):
        print(f"当前用户：{user}")

# 测试执行
controller = SomeController()
asyncio.run(controller.find_one())  # 输出：当前用户：{'id': 1, 'name': '张三'}

局限性说明 #

• Python没有原生参数装饰器语法，只能通过参数默认值绑定元数据，语法上不如TypeScript简洁直观。
• 如果参数本身需要设置默认值，需要额外处理标记逻辑，避免与业务默认值冲突。
• 标记器的作用范围依赖于方法装饰器或元类的解析逻辑，无法像TypeScript那样在编译阶段直接附加元数据。

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