在Python中如何使用inspect模块动态获取函数的入参签名？-Python教程-PHP中文网

inspect.signature() 能获取函数定义时的参数名、类型注解、默认值、参数种类等静态签名信息，但不能获取调用时的实际参数、闭包变量或装饰器动态修改后的签名。

在python中如何使用inspect模块动态获取函数的入参签名？

inspect.signature() 能拿到什么，不能拿到什么

inspect.signature() 返回的是 Signature 对象，它包含参数名、类型注解、默认值、是否可变参数（*args / **kwargs）等元信息，但不执行函数、不触发副作用、也不解析运行时传入的实际值。

常见误解是以为它能“看到”调用时的实参——其实不能。它只反映函数定义时的签名结构。

能拿到：Parameter.name、Parameter.default、Parameter.annotation、Parameter.kind（比如 POSITIONAL_ONLY）
拿不到：调用栈里的实际传参、闭包捕获的变量、装饰器动态改写的签名（除非装饰器显式保留）
注意：lambda 函数的签名里参数名可能是 arg0, arg1（CPython 实现细节），不可依赖

如何安全提取所有参数名和默认值

直接遍历 signature.parameters.values() 是最稳妥的方式，但要注意 Parameter.empty 的判断逻辑，别用 is None 或 == None。

import inspect
<p>def example(a, b: int = 42, *args, c=None, **kwargs):
pass</p><p>sig = inspect.signature(example)
for param in sig.parameters.values():
name = param.name
default = param.default if param.default is not inspect.Parameter.empty else '<no default>'
kind = param.kind
print(f'{name} ({kind.name}): {default}')
</no></p>

param.default is inspect.Parameter.empty 是唯一可靠的“无默认值”判断方式
*args 和 **kwargs 的 kind 分别是 VAR_POSITIONAL 和 VAR_KEYWORD，它们的 default 永远是 empty
如果函数被 @functools.wraps 包裹但没传 assigned 参数，signature 可能返回被包装函数的签名而非 wrapper 本身的——检查前先确认装饰器是否正确传递了 __signature__

处理带类型注解或字符串化注解的函数

Python 3.10+ 支持 from __future__ import annotations，此时注解是字符串；而 inspect.signature() 默认不求值，所以你看到的是原始字符串，不是真正的类型对象。

Python Testing

Python 测试速查：运行 pytest、使用 mock/patch、参数化、fixtures、异步、覆盖率测试。

下载

需要真实类型时，得手动调用 typing.get_type_hints()：

import inspect
import typing
<p>def f(x: 'list[int]', y: str) -> 'dict[str, int]':
...</p><p>sig = inspect.signature(f)
param_x = sig.parameters['x']
print(param_x.annotation)  # 输出：'list[int]'</p><h1>要转成真实类型，必须：</h1><p>try:
hints = typing.get_type_hints(f)
print(hints['x'])  # <class>
except Exception:
pass  # 注解非法或作用域不可达时会失败
</class></p>

get_type_hints() 会尝试在函数定义的作用域里 eval 字符串注解，失败就抛异常，不能假设它总成功
如果函数在 exec() 或动态模块中定义，且缺少 globals/locals 上下文，get_type_hints() 很可能失败
注解里用了未导入的名称（比如写了 'DataFrame' 但没 import pandas）也会崩

为什么 inspect.signature 有时返回的是 BoundArguments 而不是 Signature

它不会。这是个常见混淆点：inspect.signature() 永远返回 Signature；而 sig.bind() 或 sig.bind_partial() 才返回 BoundArguments。

如果你看到类似 missing 1 required argument 的错误，大概率是误用了 bind() 并传了不全的参数，而不是 signature() 本身的问题。

sig.bind(a=1) → 报错：缺少 b；sig.bind(a=1, b=2) → 成功返回 BoundArguments
BoundArguments.arguments 是个 dict，键是参数名，值是绑定后的实参——这才是接近“运行时参数快照”的东西，但它仍不等于调用发生时的真实状态（比如没考虑 nonlocal 修改）
想做参数校验或日志记录，bind() + apply_defaults 是常用组合，但注意它不处理 __defaults__ 以外的动态默认逻辑（比如函数体内写的 b = b or []）