如何通过Python cffi获取函数签名模型？是否有公开API可用？

一、获取set_led()函数的签名模型 #

方法1：基于CFFI解析结果的内部属性（需注意版本兼容性） #

既然你已经能获取typedef的内部模型，可沿用类似逻辑处理函数：

• 先解析目标头文件：

  from cffi import FFI
  ffi = FFI()
  with open("mymodule.h") as f:
      parsed = ffi.parse(f.read())
  

• 遍历解析结果的内部函数集合，匹配目标函数后提取签名信息：

  for func in parsed._functions:
      if func.name == "set_led":
          print(f"函数名: {func.name}")
          print(f"返回类型: {func.result_type}")
          print(f"参数列表: {[(arg.name, arg.type) for arg in func.args]}")
          break
  

  注意：带下划线的内部属性不属于官方公开API，CFFI版本迭代可能会导致接口变动，使用前需做好兼容性测试。

方法2：通过公开APItypeof()间接获取 #

如果不想依赖内部接口，可先声明或解析函数，再用typeof()提取类型信息：

from cffi import FFI
ffi = FFI()
# 方式1：直接声明函数签名
ffi.cdef("void set_led(int led_num, int brightness);")
# 方式2：解析整个头文件（二选一即可）
# ffi.cdef(open("mymodule.h").read())

# 获取函数类型对象并提取信息
func_type = ffi.typeof("set_led")
print(f"返回类型: {func_type.result}")
print(f"参数类型: {list(func_type.args)}")

二、替代内部调用的公开方案 #

CFFI没有专门暴露提取类型元数据的公开API，但可以通过以下合法方式规避内部接口：

• 官方推荐：cdef()+typeof()组合：如上述方法2所示，先通过cdef()完成头文件解析或函数声明，再用typeof()获取函数的类型结构，这是完全符合官方规范的用法。
• 第三方解析库配合：使用pycparser独立解析C头文件，生成抽象语法树（AST）后自行提取函数签名和类型定义，再与CFFI配合使用：

  from pycparser import c_parser, c_ast
  
  def extract_func_signature(ast, target_func):
      def traverse(node):
          if isinstance(node, c_ast.FuncDef) and node.decl.name == target_func:
              # 提取返回类型、参数名和类型
              ret_type = node.decl.type.type.type.names[0]
              params = [(param.name, param.type.type.names[0]) for param in node.decl.type.args.params]
              return {"name": target_func, "return_type": ret_type, "params": params}
          for child in node.children():
              res = traverse(child[1])
              if res:
                  return res
      return traverse(ast)
  
  # 解析头文件并提取set_led信息
  parser = c_parser.CParser()
  ast = parser.parse(open("mymodule.h").read())
  set_led_info = extract_func_signature(ast, "set_led")
  

• 谨慎使用半稳定内部接口_parser：ffi._parser相对其他内部属性更稳定，可通过它获取解析后的声明集合：

  parser = ffi._parser
  for decl in parser.decls:
      if hasattr(decl, 'name') and decl.name == "set_led":
          print(f"函数签名: {decl}")
          break
  

  同样，该接口不属于公开范畴，版本升级前需验证兼容性。

内容的提问来源于stack exchange，提问作者fearless_fool