inspect.signature() 返回 Signature 实例，封装函数全部调用元信息；需用 bind() 转 BoundArguments 才能安全解包，且须调用 apply_defaults() 补全默认值。
inspect.signature() 返回的是什么类型
inspect.signature() 返回一个 Signature 实例，不是字典也不是字符串，而是一个封装了函数全部调用元信息的对象。它本身不能直接传给 func(*args, **kwargs)，必须先用 bind() 或 bind_partial() 转成 BoundArguments 才能安全解包。
常见错误是拿到 Signature 后直接尝试 dict(sig) 或 sig.parameters 当成普通 dict 用 —— 虽然 sig.parameters 确实是 OrderedDict 子类，但它的 key 是 Parameter 对象，value 不是默认值本身，而是带 kind、default、annotation 等字段的完整描述。
-
Parameter.default可能是inspect.Parameter.empty，不能直接参与逻辑判断，得先比对 -
Parameter.kind区分POSITIONAL_ONLY、KEYWORD_ONLY等，影响参数是否允许被传为 keyword - 对内置函数（如
len、print）调用signature()可能抛ValueError，因为 C 实现函数不提供签名信息
如何安全地把 signature 转成可调用的参数映射
最常用路径是：获取 Signature → 用 bind() 绑定实际参数 → 调用 apply_defaults() 补全缺省值 → 取 arguments 属性得到最终字典。
注意 bind() 是严格校验的，传入不合法参数会立刻报 TypeError；如果只想做“尽力绑定”，用 bind_partial() 更合适。
立即学习“Python免费学习笔记（深入）”；
import inspect
<p>def example(a, b: int, c=3, *args, d=None, **kwargs):
pass</p><p>sig = inspect.signature(example)
bound = sig.bind(1, 2, d="x") # 不传 c，也不传 args/kwargs
bound.apply_defaults() # 这步必须加，否则 bound.arguments 不含 c
print(bound.arguments) # {'a': 1, 'b': 2, 'c': 3, 'd': 'x'}
- 没调
apply_defaults()时，bound.arguments里不会出现有默认值但未传入的参数（如c） -
*args和**kwargs在bound.arguments中分别对应'args'和'kwargs'键，值为 tuple/dict - 若函数含
POSITIONAL_ONLY参数（如 C 扩展或用了/语法），bind()会拒绝 keyword 传入，报错提示 “takes X positional arguments but Y were given”
inspect.signature() 在装饰器中怎么避免破坏原函数签名
直接写 @wraps(func) 并不够 —— 如果装饰器内部修改了 __signature__，或者返回了一个新函数但没显式设置签名，调用方看到的仍是装饰器闭包的签名（通常是 (*args, **kwargs)），导致 IDE 提示不准、help() 失效、框架（如 FastAPI）无法正确解析参数。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
正确做法是在装饰器返回函数前，手动拷贝原函数的 __signature__：
from functools import wraps import inspect <p>def my_decorator(func): @wraps(func) def wrapper(*args, *<em>kwargs): return func(</em>args, **kwargs)</p><h1>关键：把原函数签名赋给 wrapper</h1><pre class="brush:php;toolbar:false;">wrapper.__signature__ = inspect.signature(func) return wrapper
- 不要依赖
@wraps自动处理__signature__：Python 3.5+ 的@wraps默认同步它，但某些旧版本或自定义wraps实现可能漏掉 - 若装饰器本身要增删参数（如注入
request），应基于原Signature构造新Signature，而不是硬编码__signature__ -
inspect.Signature构造需要Parameter列表，不能直接传 dict；新增参数要用Parameter(name, kind, default=..., annotation=...)显式创建
为什么 getfullargspec() 正在被 signature() 替代
inspect.getfullargspec() 返回的是命名元组，字段固定（args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, annotations），无法表达 POSITIONAL_ONLY、KEYWORD_ONLY 的边界位置，也不能表示 Union[int, str] 这类复杂注解的结构化信息。
而 signature() 返回的 Signature 是面向未来的：它把每个参数都建模为 Parameter 对象，kind 字段明确区分调用约束，annotation 字段保留原始 AST 类型（而非字符串），且支持 __future__.annotations 延迟求值。
-
getfullargspec()对带/分隔符的函数（如def f(a, b, /, c):）会把a,b归入args，但丢失 “必须 positional” 这一语义 -
signature()中Parameter.kind == Parameter.POSITIONAL_ONLY明确标识该参数不可 keyword 传入 - 第三方库（如
pydantic,click）已全面转向signature()解析，继续用getfullargspec()可能导致兼容性断裂
真正难处理的是动态生成的函数（比如用 types.FunctionType 构造的），它们的 __signature__ 默认为 inspect.Signature.empty，必须手动 attach，否则任何基于签名的逻辑都会 fallback 到模糊匹配。
