我之前也碰到过一模一样的报错，苹果文档说可以传顶级Swift函数，但实际写代码时却触发了A C function pointer can only be formed from a reference to a 'func' or a literal closure错误，其实问题出在类型匹配的严格要求上，下面给你拆解原因和解决办法：

核心原因：签名必须完全匹配C函数指针 #

Swift对C函数指针的类型校验非常严格，哪怕你的顶级函数看起来逻辑上符合要求，只要参数、返回值的类型（甚至是可选性、指针类型）和C端的函数指针定义有一点出入，就会报错。

举个例子，假设C端的函数指针声明是这样的：

typedef NSString *_Nonnull (*CopyDescriptionFunc)(void *_Nonnull obj);
void registerCopyDescription(CopyDescriptionFunc copyDescription);

对应的Swift顶级函数必须严格对齐这个签名：

// 正确的顶级函数：参数是UnsafeRawPointer，返回值是NSString
func customCopyDescription(_ obj: UnsafeRawPointer) -> NSString {
    return NSString(string: "Custom desc for \(obj)")
}

如果你的函数写成这样就会报错：

// 错误：返回值用了Swift的String而非NSString
func badCopyDescription(_ obj: UnsafeRawPointer) -> String {
    return "Bad desc"
}

// 错误：参数用了AnyObject而非UnsafeRawPointer
func anotherBadCopy(_ obj: AnyObject) -> NSString {
    return NSString(string: "Oops")
}

常见的其他错误场景 #

• 误传函数调用结果而非函数引用
  如果你写了registerCopyDescription(customCopyDescription())（加了括号），相当于把函数执行后的返回值传进去，而不是函数本身的指针，这肯定会触发错误，正确写法是去掉括号：registerCopyDescription(customCopyDescription)

• 传入类方法而非顶级函数
  类方法带有隐式的self参数，不符合C函数指针无上下文的要求，不能直接传入。这种情况可以用闭包包裹：

  class MyClass {
      func classCopyDesc(_ obj: UnsafeRawPointer) -> NSString {
          return NSString(string: "Class desc")
      }
  }
  
  let instance = MyClass()
  // 用闭包捕获self，转换为符合要求的函数指针
  registerCopyDescription { obj in
      instance.classCopyDesc(obj)
  }
  

正确的调用示例 #

// 传入顶级函数引用
registerCopyDescription(customCopyDescription)

// 传入闭包字面量（符合文档说明）
registerCopyDescription { obj in
    return NSString(string: "Closure-based desc for \(obj)")
}

// 传入nil（如果C函数指针允许可选）
registerCopyDescription(nil)

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