0

0

typing.ParamSpec 如何保留被装饰函数的签名参数类型

舞夢輝影

舞夢輝影

发布时间:2026-01-25 18:53:02

|

733人浏览过

|

来源于php中文网

原创

能,ParamSpec 需配合 Callable 和泛型绑定使用;单独使用仅捕获参数结构,不保留类型信息;IDE 显示 (*args, **kwargs) 是因返回类型未正确声明 P;关键点为显式声明 P、用 Callable[P, R] 约束、wrapper 中必须注解为 *args: P.args 和 **kwargs: P.kwargs。

typing.paramspec 如何保留被装饰函数的签名参数类型

ParamSpec 能不能保留原函数的参数类型?

能,但必须配合 Callable 和泛型绑定使用,单独用 ParamSpec 不会自动推导参数类型 —— 它只捕获参数结构(数量、名称、是否可变),不携带类型注解信息。

为什么 @decorator 后 IDE 显示参数变成 (*args, **kwargs)?

因为装饰器返回类型没写对。常见错误是把返回类型硬写成 Callable[..., ReturnType],或者漏掉 P 绑定:

  • 错: def my_dec(f: Callable) -> Callable: ... → 彻底丢弃所有签名
  • 错: def my_dec(f: Callable[P, R]) -> Callable[P, R]: ... → 缺少泛型参数声明,P 未定义
  • 对: def my_dec(f: Callable[P, R]) -> Callable[P, R]: ...,且前面声明 P = ParamSpec('P')

完整可工作的 ParamSpec 签名保留写法

关键点有三个:显式声明 P、用 Callable[P, R] 约束输入输出、装饰器内部调用必须保持原调用形式(不能改写成 f(*args, **kwargs) 以外的形式):

from typing import Callable, ParamSpec, TypeVar

P = ParamSpec('P')
R = TypeVar('R')

def log_calls(f: Callable[P, R]) -> Callable[P, R]:
    def wrapper(*args: P.args, **kwargs: P.kwargs) -> R:
        print(f"Calling {f.__name__}")
        return f(*args, **kwargs)
    return wrapper

@log_calls
def greet(name: str, age: int) -> str:
    return f"Hello {name}, {age} years old"

此时 greet 在 IDE 中鼠标悬停仍显示 (name: str, age: int) -> str,类型检查器也能正确校验传参。

容易被忽略的坑:wrapper 参数注解必须用 P.args / P.kwargs

如果写成 def wrapper(*args, **kwargs)def wrapper(*args: Any, **kwargs: Any),类型系统就断连了 —— P 的结构信息只在 *args: P.args**kwargs: P.kwargs 这种显式绑定时才传递下去:

  • *args: P.args 告诉类型检查器:“这些位置参数的类型和顺序,跟原函数一致”
  • **kwargs: P.kwargs 对应关键字参数的键名与类型约束
  • 漏掉任一,mypy/pyright 就退回 Anyobject,签名即失效

ParamSpec 的“保留签名”本质是类型系统里的结构投影,不是运行时魔法 —— 写错一个注解,整条链就断了。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

401

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

543

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

53

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

197

2025.08.29

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

63

2026.01.23

c++空格相关教程合集
c++空格相关教程合集

本专题整合了c++空格相关教程,阅读专题下面的文章了解更多详细内容。

60

2026.01.23

yy漫画官方登录入口地址合集
yy漫画官方登录入口地址合集

本专题整合了yy漫画入口相关合集,阅读专题下面的文章了解更多详细内容。

238

2026.01.23

漫蛙最新入口地址汇总2026
漫蛙最新入口地址汇总2026

本专题整合了漫蛙最新入口地址大全,阅读专题下面的文章了解更多详细内容。

400

2026.01.23

C++ 高级模板编程与元编程
C++ 高级模板编程与元编程

本专题深入讲解 C++ 中的高级模板编程与元编程技术,涵盖模板特化、SFINAE、模板递归、类型萃取、编译时常量与计算、C++17 的折叠表达式与变长模板参数等。通过多个实际示例,帮助开发者掌握 如何利用 C++ 模板机制编写高效、可扩展的通用代码,并提升代码的灵活性与性能。

17

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Java 教程
Java 教程

共578课时 | 50.8万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号