delegate* 不是常规 delegate 的替代品,因其仅支持 static、unmanaged、无泛型无异常的纯方法,不支持闭包、实例方法或托管类型,且需 unsafe 上下文和严格签名匹配。

为什么 C# 里 delegate* 不是常规 delegate 的替代品
delegate* 是 C# 9 引入的非托管函数指针语法,本质是 void* 级别的裸地址,不带任何 CLR 运行时元数据或闭包支持。它只在 unsafe 上下文中有效,且调用目标必须是 static、unmanaged(无托管引用)、无泛型、无异常处理的纯方法。这意味着你不能把它指向一个捕获了局部变量的 lambda,也不能指向实例方法——哪怕加 static 修饰符也不行,因为实例方法隐含 this 参数,破坏调用约定。
常见错误现象:CS8802: A function pointer cannot point to a method that contains a 'this' parameter 或 CS8805: Method 'X' is not unmanaged。根本原因不是写法错,而是方法签名不符合底层 ABI 要求。
- 必须用
unmanaged修饰符声明方法(C# 11+),或确保方法体中不出现任何托管类型(如string、object、List) - 参数和返回值只能是基本类型(
int、float、IntPtr)、void,或unmanaged struct - 不能有
try/catch、using、await,也不能调用任何可能触发 GC 的 API
如何正确定义并调用 delegate*
定义格式固定:delegate* unmanaged[Cdecl] 。方括号里的调用约定可选 Cdecl、Stdcall、Fastcall(x64 下后两者被忽略),不写则默认为 Cdecl。注意这不是泛型类型, 里填的是真实类型,不是占位符。
实操示例:
unsafe
{
// 正确:静态、unmanaged、无副作用的方法
static int Add(int a, int b) => a + b;
// 获取函数指针(必须显式 cast)
delegate* unmanaged[int, int, int] ptr = &Add;
// 调用
int result = ptr(3, 4); // result == 7
}
关键点:
-
&Add只对静态方法有效;实例方法需先提取为委托再转指针(但会失去性能优势) - 不能直接写
ptr(3, 4)在 safe 上下文——必须包裹在unsafe块中 - 如果方法签名含指针(如
int* p),调用时传参也必须是兼容指针,编译器不会自动转换
在 P/Invoke 回调场景中用 delegate* 替代 Marshal.GetFunctionPointerForDelegate
传统 P/Invoke 回调常通过 delegate + Marshal.GetFunctionPointerForDelegate 实现,但该方式需分配托管委托对象、注册 GC 句柄、生成 thunk,开销大且易因提前回收导致崩溃。而 delegate* 是纯地址,零分配、零 GC 压力,适合高频回调(如音频处理、游戏帧循环、硬件中断响应)。
使用前提:
- 原生库明确要求传入 C-style 函数指针(如
typedef void (*callback_t)(int, float)) - 你的回调逻辑足够简单,能写成
unmanaged方法 - 你控制调用生命周期——
delegate*不做生存期管理,若原生代码长期持有指针而托管方法被 JIT 优化掉或 DLL 卸载,就会 crash
典型模式:
[DllImport("native.dll")]
static extern void RegisterCallback(delegate* unmanaged[int, void] cb);
unsafe
{
static void OnEvent(int code) { / ... / }
RegisterCallback(&OnEvent);
}
注意:这里没用 fixed 或 GCHandle,因为 &OnEvent 指向的是 JIT 编译后的固定代码地址,只要程序域不卸载,它就一直有效。
性能差异在哪?什么情况下反而更慢
纯粹调用开销上,delegate* 比 delegate 快 3–5 倍(实测 x64,无内联时),主要省去了委托对象虚表查表、多层间接跳转、空引用检查。但真实收益取决于上下文:
- 如果回调体本身要分配内存、访问集合、调用 LINQ,那函数指针省下的几纳秒毫无意义
- 若需从回调中反向调用托管代码(比如通知 UI 线程),必须通过额外机制(如
QueueUserWorkItem、Task.Run)桥接,此时安全边界成本远超指针调用节省 - Debug 模式下 JIT 可能不内联
unmanaged方法,导致实际性能不如 Release 模式下的普通 delegate
最容易被忽略的一点:delegate* 完全绕过 .NET 的类型安全和异常传播机制。一旦被调用的方法抛出异常(哪怕只是访问了 null 指针),会直接终止进程,没有任何 catch 机会。这不是 bug,是设计使然——你要的本来就是 C 级别控制权。










