0

0

typing.ParamSpec 如何保留被装饰函数的 *args / **kwargs 类型

舞姬之光

舞姬之光

发布时间:2026-01-31 18:49:21

|

415人浏览过

|

来源于php中文网

原创

不能——ParamSpec仅记录参数结构“形状”,不保存args/kwargs的具体类型注解,P.args恒为tuple[object, ...],需用Concatenate显式拼接才能保留如args: float等类型信息。

typing.paramspec 如何保留被装饰函数的 *args / **kwargs 类型

ParamSpec 能不能原样保留 *args**kwargs 的类型?

不能直接保留——ParamSpec 本身不捕获 *args: P.args**kwargs: P.kwargs 的具体类型,它只记录参数结构的“形状”,不保存动态参数的实际注解。如果你写 def f(*args: int, **kwargs: str)P = ParamSpec('P') 绑定后,P.argstuple[object, ...]P.kwargsdict[str, Any],原始 intstr 信息就丢了。

Concatenate + 显式标注才能保留 *args 类型

要让装饰器把 *args: int 传下去,必须手动拆开参数结构,用 Concatenate 把固定参数和可变参数拼起来,并显式写出 *args 的类型。常见错误是只写 P,结果类型检查器认为 *args 是泛型占位符而非具体类型。

  • ParamSpec 适合转发签名但不关心 *args/**kwargs 具体类型(比如日志装饰器)
  • 若需保留 *args: int,定义装饰器时得用 Callable[Concatenate[int, P], R],并让被装饰函数显式标注 *args: int
  • **kwargs 同理:用 Concatenate[Unpack[T], P](Python 3.12+)或配合 TypedDict 模拟强类型 **kwargs

实际例子:带类型感知的重试装饰器

下面这个装饰器能正确推导 f(x: str, *args: float, **kwargs: bool)*argsfloat**kwargsbool

万兴喵影
万兴喵影

国产剪辑神器

下载
from typing import Callable, TypeVar, ParamSpec, Concatenate, Unpack, TypedDict
import time

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

假设我们只关心 *args: float,其他保持原样

def retry( func: Callable[Concatenate[float, P], R] ) -> Callable[Concatenate[float, P], R]: def wrapper(*args: float, *kwargs: P.kwargs) -> R: for _ in range(3): try: return func(args, **kwargs) except Exception: time.sleep(1) raise RuntimeError("Failed after retries") return wrapper

使用时必须显式标注 *args / **kwargs 类型

def my_func(x: str, *args: float, **kwargs: bool) -> int: return len(x) + sum(int(a) for a in args)

wrapped = retry(my_func) # ✅ mypy 知道 wrapped 接收 *args: float, **kwargs: bool

为什么 P.args 总是 tuple[object, ...]

这是 ParamSpec 的设计限制:它抽象的是“调用时参数如何分组”,不是“每个参数的静态类型”。P.args 对应的是 *args 形参整体,而 Python 类型系统中 *args: T 的类型本质是 tuple[T, ...],但 P 不存储这个 T——它只存 tuple[object, ...] 作为占位。真正要恢复 T,只能靠 Concatenate 显式拼接,或用 Callable[[int, str, *tuple[float, ...]], None] 这种硬编码方式。

所以别指望 ParamSpec 自动推导出 *args 的元素类型;它最常被误用的地方,就是以为 P.args 能当 tuple[float, ...] 用。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
css中float用法
css中float用法

css中float属性允许元素脱离文档流并沿其父元素边缘排列,用于创建并排列、对齐文本图像、浮动菜单边栏和重叠元素。想了解更多float的相关内容,可以阅读本专题下面的文章。

580

2024.04.28

C++中int、float和double的区别
C++中int、float和double的区别

本专题整合了c++中int和double的区别,阅读专题下面的文章了解更多详细内容。

103

2025.10.23

string转int
string转int

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

503

2023.08.02

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

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

545

2024.08.29

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

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

113

2025.08.29

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

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

200

2025.08.29

go语言 注释编码
go语言 注释编码

本专题整合了go语言注释、注释规范等等内容,阅读专题下面的文章了解更多详细内容。

2

2026.01.31

go语言 math包
go语言 math包

本专题整合了go语言math包相关内容,阅读专题下面的文章了解更多详细内容。

1

2026.01.31

go语言输入函数
go语言输入函数

本专题整合了go语言输入相关教程内容,阅读专题下面的文章了解更多详细内容。

1

2026.01.31

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 3.7万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.3万人学习

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

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