C#解构仅支持元组和含合法Deconstruct方法的类型；自定义类需满足public、实例、void返回、全out参数等严格签名，否则静默忽略并导致默认值错误。
解构语法在 C# 中不是通用能力，它只对元组和实现了合法 Deconstruct 方法的类型生效；其他类型直接写 (a, b) = obj 会编译失败，报错 CS8129。
为什么自定义类解构失败？检查 Deconstruct 方法签名
编译器只认一种契约：必须是 public（或至少当前作用域可见）、实例、void 返回、所有参数带 out。少一个 out、多一个 ref、加个返回值、写成 static 或 private（跨程序集时不可见）——都会导致整个方法被静默忽略，解构变量全为默认值（如 0、null），运行时才可能暴露未赋值错误。
-
public void Deconstruct(out string name, out int age)✅ 正确 -
private void Deconstruct(out string name, out int age)✅ 同一程序集内可用 -
public static void Deconstruct(out string name, out int age)❌ 静默跳过 -
public (string, int) Deconstruct()❌ 编译器不识别 -
public void Deconstruct(string name, out int age)❌ 混入非out参数，整重载失效
Deconstruct 的参数个数决定你能解构出几个变量
C# 解构不看字段名、不比类型、不依赖命名约定，纯粹按你写的变量数量匹配对应参数个数的 Deconstruct 重载。有两参数就只能 var (x, y) = obj;，三参数才支持 var (x, y, z) = obj;。弃元 _ 不影响计数：var (_, y) = obj; 仍调用两参数版本。
- 有
Deconstruct(out string, out int)和Deconstruct(out string, out int, out DateTime?)两个重载 -
var (n, a) = person;→ 调用两参数版 -
var (n, a, d) = person;→ 调用三参数版 - 没有“智能匹配”：哪怕你只想要
Name和Email，但只写了两参数Deconstruct，就不能用var (n, e) = person;提取这两个字段以外的组合
嵌套解构和 foreach 中的隐性陷阱
嵌套解构（如 var (n, (x, y)) = obj;）要求每一层类型都实现对应参数个数的 Deconstruct；foreach (var (n, a) in list) 则要求 list 是 IEnumerable<T> 且 T 有两参数 Deconstruct，否则编译不过。
- 所有
out参数必须在方法体内显式赋值，哪怕你只打算用其中一两个 —— 忘了age = this.Age;就会触发编译错误Use of unassigned out parameter -
Deconstruct是普通方法，访问this.Address.City时若Address为null，直接抛NullReferenceException，不是解构失败 - 结构体解构会复制值，
Deconstruct内部修改字段不影响原实例；类则作用于引用对象本身
最常被忽略的一点：参数顺序即契约顺序。一旦 Deconstruct(out int id, out string name) 定义好了，调用方就必须按这个顺序接收 —— 改顺序等于改公开 API，所有下游代码都要同步调整。
