使用UnsafeAccessor 访问私有字段

UnsafeAccessor 是 .NET8+ 引入的一个 底层元编程工具，它允许你在 不依赖反射 的情况下，高效地访问私有字段、属性、方法甚至构造函数。它的使用场景非常明确：你需要访问一个类型的私有成员，但你不能或不想改变该类型的可见性设计。低版本请使用ILAccess.Fody  

✅ 使用场景（为什么需要它）

1. 高性能框架/序列化库

• 比如：System.Text.Json、MessagePack、Dapper、EF Core 等。
• 这些库需要在运行时访问对象的私有字段（如 _id、_backingField），但反射太慢，表达式树又复杂。
• UnsafeAccessor 提供了一种 JIT 编译时生成访问器 的方式，性能接近直接字段访问。

2. 测试代码访问私有状态

• 单元测试中，有时需要验证某个类的内部状态（如缓存是否清空、私有计数器是否正确）。
• 你不想为了测试而把字段改成 internal 或 public，这会破坏封装。
• UnsafeAccessor 让你在不破坏封装的前提下，安全地访问私有状态。

3. 与旧代码或第三方库交互

• 你依赖的库没有暴露某个字段或方法，但你必须访问它（比如绕过 bug、扩展功能）。
• 你不能修改源码，也不能用反射（因为反射在 AOT 或 NativeAOT 下不可用）。
• UnsafeAccessor 是 AOT 友好 的，因为它在编译时生成访问器，不需要运行时反射。

❗为什么不用反射？

特性	反射	UnsafeAccessor
性能	慢（运行时查找）	快（JIT 生成直接访问）
AOT 支持	❌ 不支持	✅ 支持
编译时检查	❌ 没有	✅ 有（方法签名匹配）
可读性	差（字符串名）	好（强类型）

✅ 示例：访问私有字段

csharp

 

class MyClass
{private int _secret = 42;
}static class Accessors
{[UnsafeAccessor(UnsafeAccessorKind.Field, Name = "_secret")]public static extern ref int GetSecret(MyClass obj);
}// 使用
var obj = new MyClass();
ref int secret = ref Accessors.GetSecret(obj);
Console.WriteLine(secret); // 输出 42

⚠️ 注意

• 它是 unsafe 的，意味着你打破了封装，使用时必须清楚后果。
• 不适合业务逻辑代码，只适合框架、测试、底层库。
• 如果字段名拼错，会在 JIT 时报错，不是编译时报错。

✅ 总结一句话

UnsafeAccessor 是 .NET8+ 为高性能底层代码提供的封装安全破坏工具，用于在不依赖反射的前提下，高效访问私有成员，特别适合序列化、测试、框架开发等场景。