inspect.signature() 能获取可调用对象运行时实际暴露的参数结构（含注解、默认值），但不能自动继承父类参数、还原args/*kwargs模糊声明、处理functools.wraps覆盖或__new__拦截的情况。
inspect.signature() 能拿到什么，不能拿到什么
inspect.signature() 返回的是可调用对象的「调用时签名」，不是类定义时的原始语法。它对 __init__ 方法生效，但不会自动展开父类参数，也不会还原带 *args 或 **kwargs 的模糊声明——它只反映运行时实际暴露的参数结构。
常见误区是以为它能直接给出「类实例化时所有可用参数」，其实它只返回该类自身 __init__ 的签名；如果父类有参数，而子类没显式重写 __init__，signature() 会返回 object.__init__ 的空签名 ()，而不是继承来的参数。
- 想获取完整初始化参数？得递归向上查基类
__init__并合并 -
signature()对 dataclass 或 attrs 自动生成的__init__是有效的，但对使用__new__拦截初始化的类可能不准确 - 若类用了
functools.wraps包装__init__，签名可能被覆盖，需检查__wrapped__
如何安全提取类的 __init__ 签名
别直接对类调用 inspect.signature()，它会报 ValueError: callable is not supported。正确做法是明确指向 __init__ 方法：
import inspect <p>class Person: def <strong>init</strong>(self, name: str, age: int = None): self.name = name self.age = age</p><p>sig = inspect.signature(Person.<strong>init</strong>)</p><h1>注意：第一个参数是 self，通常要跳过</h1><p>params = list(sig.parameters.values())[1:] # 剔除 self</p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill7657" title="python 查询技能"><img src="https://img.php.cn/upload/skill/000/000/081/179161384046229.jpg" alt="python 查询技能" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a rel="nofollow" href="/xiazai/skill7657" title="python 查询技能" class="overflowclass">python 查询技能</a> <p class="overflowclass">查询客流数据，输出JSON格式，可直接导入Bitable等可视化工具</p> </div> <a rel="nofollow" href="/xiazai/skill7657" title="python 查询技能" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div>
更稳妥的方式是用 inspect.isfunction() 或 inspect.ismethod() 先确认可调用性，再取签名：
- 用
getattr(cls, '__init__', object.__init__)防止自定义类没定义__init__ - 对绑定方法（如实例方法）要用
inspect.signature(method.__func__)，否则会把self当作第一个参数误判 - 如果类继承链深，且你想保留参数顺序和默认值一致性，建议用
inspect.getfullargspec()辅助校验
处理带类型注解和默认值的参数
inspect.signature() 能读出 Parameter.annotation 和 Parameter.default，但要注意它们的值含义：
-
Parameter.empty表示无类型注解或无默认值，不是None - 默认值为
None是合法的，但Parameter.default is None不代表“没设默认值”，得和Parameter.empty对比判断 - 类型注解可能是字符串（如启用 postponed evaluation）、
typing.Any或真实类型，不能直接用于 isinstance 判断 - dataclass 中的
field(default=...)会被正确映射到Parameter.default，但field(default_factory=list)映射为Parameter.empty，需额外检查__dataclass_fields__
示例判断逻辑：
for param in sig.parameters.values():
if param.name == 'self':
continue
has_default = param.default is not inspect.Parameter.empty
has_annotation = param.annotation is not inspect.Parameter.empty
兼容 Python 3.7+ 与旧版本的签名提取
Python 3.5 引入 inspect.signature()，但对某些内置类（如 dict、list）仍返回 Signature.empty。3.7+ 支持 eval_str 参数控制字符串注解解析，但旧版本不支持。
- 在 Python inspect.signature() 对部分 C 实现类（如
datetime.datetime）可能失败， fallback 方案是用inspect.getfullargspec()+ 手动拼接 - 若目标环境不确定，先尝试
signature()，捕获ValueError或TypeError后降级 -
getfullargspec()不识别kwonly参数和注解，适合快速获取参数名和默认值元组，但丢失语义细节
真正容易被忽略的是：签名对象本身是不可变的，修改 Parameter 需重建 Signature，且 bind() 对参数缺失/多余敏感——调试时别只看 str(sig)，要逐个 inspect Parameter.kind（比如 POSITIONAL_ONLY 在 help() 里不显示，但影响调用方式）。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
