inspect.signature() 是获取函数参数信息的首选方法，能完整解析参数名、类型注解、默认值等，返回 signature 对象；使用时需注意装饰器和 functools.partial 的影响，推荐配合 inspect.unwrap() 提高兼容性。
inspect.signature() 是获取参数信息的首选方法
Python 3.5+ 中，inspect.signature() 已取代过时的 inspect.getargspec()，能完整解析函数签名，包括参数名、类型注解、默认值、可变参数等。它返回一个 Signature 对象，结构清晰且兼容各种函数类型（普通函数、lambda、带装饰器的函数等）。
关键点：必须传入**未被装饰器完全替换**的原始函数对象；若用了 @functools.wraps，通常没问题；但某些框架（如 Flask 的 @route）可能破坏签名，需额外处理。
示例：
import inspect
<p>def example(a, b: int = 10, *args, c=20, **kwargs):
pass</p><p>sig = inspect.signature(example)
for name, param in sig.parameters.items():
print(f"{name}: default={param.default!r}, kind={param.kind}")
</p>
提取参数名和默认值的实用写法
直接遍历 signature.parameters 即可，但要注意区分不同参数类型对 default 的含义：
-
param.default是显式默认值（如b=10、c=20），对必填参数为inspect.Parameter.empty -
*args和**kwargs的default恒为inspect.Parameter.empty，不能当作“无默认值”来判断是否可选 - 只关心“有默认值的命名参数”时，应过滤
param.kind == inspect.Parameter.KEYWORD_ONLY或inspect.Parameter.POSITIONAL_OR_KEYWORD且param.default is not inspect.Parameter.empty
常用提取逻辑：
def get_param_defaults(func):
sig = inspect.signature(func)
return {
name: param.default
for name, param in sig.parameters.items()
if param.default is not inspect.Parameter.empty
and param.kind in (inspect.Parameter.POSITIONAL_OR_KEYWORD, inspect.Parameter.KEYWORD_ONLY)
}
<h1>结果：{'b': 10, 'c': 20}</h1><p></p>
遇到 functools.partial 时要先调用 inspect.unwrap()
当你对部分应用后的函数（如 partial(func, a=1)）直接调用 inspect.signature()，会得到 partial 自身的签名（只有 *args, **keywords），而非原函数参数。这是最常踩的坑。
解决方法是先用 inspect.unwrap() 剥离所有已知包装器（包括 @wraps 和 partial）：
from functools import partial import inspect <p>def f(x, y=5): return x + y</p><p>pf = partial(f, x=10)</p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2506" title="Python 3.14.2"><img src="https://img.php.cn/upload/manual/001/221/864/6a696c31dfa4a111.webp" alt="Python 3.14.2" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a rel="nofollow" href="/xiazai/gongju/2506" title="Python 3.14.2" class="overflowclass">Python 3.14.2</a> <p class="overflowclass">Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。</p> </div> <a rel="nofollow" href="/xiazai/gongju/2506" title="Python 3.14.2" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div><h1>错误：inspect.signature(pf) → (*args, **keywords)</h1><h1>正确：</h1><p>sig = inspect.signature(inspect.unwrap(pf))</p><h1>→ (x: int = 10, y: int = 5)</h1><p></p>
注意：inspect.unwrap() 在 Python 3.5+ 可用；若目标函数被多层未知装饰器包裹（如某些 ORM 方法），unwrap 可能失效，此时需结合 __wrapped__ 手动回溯或改用 AST 解析。
inspect.getfullargspec() 还能用，但有明显局限
该函数在 Python 3.5+ 仍存在，返回 FullArgSpec 命名元组，字段包括 args、defaults、kwonlyargs、kwonlydefaults 等。但它不支持类型注解，且对 functools.partial、内置函数、C 扩展函数常抛 ValueError 或返回不完整结果。
仅建议用于兼容旧代码或明确知道函数是纯 Python 定义且无装饰器的场景。例如：
import inspect <p>def g(a, b=None): pass</p><p>spec = inspect.getfullargspec(g)</p><h1>spec.args == ['a', 'b']</h1><h1>spec.defaults == (None,)</h1><p></p>
但一旦换成 g = partial(g, a=1)，getfullargspec() 就会失败，而 signature() + unwrap() 组合更鲁棒。
参数名和默认值的映射关系看似简单，实际取决于函数是否被包装、是否含注解、是否含仅限关键字参数——这些细节在动态生成文档、参数校验或自动 mock 时都会浮出水面。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
