元组是 C# 7.0 引入的轻量级数据结构用于临时组合多个值无需定义专门的类或结构。元组是有序的数据结构成员按声明/创建时的顺序排列。这里的元组只指值元组元组类型在C#7.0前是有一个专门的内置类型Tuple但现在不建议使用新的是ValueTupleC# 元组家族 ├── Tupleclass只读无语法糖→ 老代码用不推荐 └── ValueTuplestruct可修改有语法糖→ 你学的就是这个 └── 语法糖(string Name, int Age) ← 要学的这个Tuple示例代码// ❌ 旧式 Tuple不推荐 Tuple类型1,类型2,类型3 变量名 Tuple.Creat(值1,值2,值3); // 引用类型在堆上分配 Tuplestring, int t1 Tuple.Create(张三, 30); Tuplestring, int t2 new Tuplestring, int(李四, 25); // 访问只能用 Item1, Item2... Console.WriteLine(t1.Item1); // 张三 Console.WriteLine(t1.Item2); // 30 // 只读不能修改 // t1.Item1 王五; // ❌ 编译错误 // ✅ 现代 ValueTuple推荐 (string Name, int Age) modern (张三, 30); var modern2 (Name: 李四, Age: 25);对比项TupleValueTuple引入版本C# 4.0 / .NET 4.0C# 7.0 / .NET 4.7类型class引用类型struct值类型内存分配堆栈可变性只读可修改自定义名称❌ 不支持✅ 支持语法糖❌ 无✅(a, b)语法解构❌ 需手动✅ 原生支持性能较差较好推荐度不推荐旧代码推荐使用1元组类型和变量定义元组定义分为两种方式1.先用using定义元祖类型名再实例化2.直接实例化显式实例化直接写好类型名隐式实例化用var//1.先用using给元组类型命名再实例化 //方式1不定义元组成员标签名 using 元组类型名 (类型1, 类型2, 类型3); using tup1 (string, int); //方式2定义元组成员标签名 using 元组类型名 (类型1 标签名1, 类型2 标签名2, 类型3 标签名3); using tup2 (string Name, int Age); //2.显式定义类型并实例化 //方式1不定义元组成员标签名 (类型1,类型2,类型3) 变量名 (值1, 值2, 值3); (string, int) tup3 (hello, 123); //方式2定义元组成员标签名 (类型1 标签名1, 类型2 标签名2, 类型3 标签名3) 变量名 (标签名1:值1, 标签名2:值2, 标签名3:值3); (string N, int A) p (Name: 张三, Age: 30); //3.隐式定义类型并实例化 //方式1不定义元组成员标签名 var 变量名 (值1,值2,值3); //方式2定义元组成员标签名 var 变量名 (标签1:值1, 标签2:值2, 标签3:值3);2元组元素的访问元组元素访问分为两种情况类型无标签的左值无标签通过变量名.ItemX访问类型有标签的左值有标签通过变量名.ItemX或变量名.标签名访问/* 元祖元素访问 1.如果左侧是无标签的只能通过默认的 ItemX 属性访问成员。X是元组的元素序号 注意元组的元素序号从 1 开始 2.如果左侧是有标签的既可以通过 元祖名.ItemX 访问也可以通过 元组名.标签名访问 */ //1.1不定义元组成员标签名 tup1 p0 (张三, 30); Console.WriteLine(p0.Item1); //1.2定义元组成员标签名 tup2 p1 (张三, 30); Console.WriteLine(p1.Item1); //p1.Item1和p1.Name访问的是一样的元素 Console.WriteLine(p1.Name);3左右值标签的规则左值的标签构成元组的每个类型对应的标签右值的标签元组实例化后值的标签只方便查看值的含义无实际语法作用/* 给元组变量赋值的时候右边值的标签没有意义只是作为一个标记方便查看值代表什么 using 别名定义时指定的标签相当于左边声明的标签。也遵循同样的原则 左边或 using 定义的标签决定你能用什么标签访问右边只提供值按位置匹配 */ //1.左无右有 → 只能用 Item右边标签丢失 (string, int) p2 (Name: 张三, Age: 30); Console.WriteLine(p2.Item1); // ✅ 张三 // Console.WriteLine(p2.Name); // ❌ 不存在 //2.左有右无 → 用左边的标签 (string Name, int Age) p3 (李四, 25); Console.WriteLine(p3.Name); // ✅ 李四 Console.WriteLine(p3.Age); // ✅ 25 //3.左右都有 → 用左边的标签右边标签被忽略 (string FullName, int Years) p4 (Name: 王五, Age: 28); Console.WriteLine(p4.FullName); // ✅ 王五 Console.WriteLine(p4.Years); // ✅ 28 // Console.WriteLine(p4.Name); // ❌ 不存在左边没有 Name // Console.WriteLine(p4.Age); // ❌ 不存在左边没有 Age //4.左右都无 → 只能用 Item (string, int) p5 (赵六, 32); Console.WriteLine(p5.Item1); // ✅ 赵六左边变量声明右边赋值结果访问方式无标签(string, int)无标签(a,1)只能用Item1, Item2无标签(string, int)有标签(Name:a, Age:1)只能用Item1, Item2右边标签被忽略有标签(string N, int A)无标签(a,1)可以用N, A或Item1, Item2有标签(string N, int A)有标签(Name:a, Age:1)可以用N, A右边标签被忽略4元组解构元组的解构允许将元组中的元素方便地提取出来赋值给单独的变量。包括位置解构最常用按名称解构C# 7.3 增强支持弃元Discard如果学过Python这和Python的拆包比较像。4.1位置解构按顺序对应不关心变量名是否与元组元素名一致。var tuple (name: Alice, age: 30); (string personName, int personAge) tuple; // ✅ 顺序匹配变量名任意 // ✅ 这行代码做了两件事 // 1. 声明了两个新变量 personName (string) 和 personAge (int) // 2. 把 tuple 的第1个元素赋值给 personName得到 Alice // 3. 把 tuple 的第2个元素赋值给 personAge得到 30 //等价于 string personName tuple.Item1; // 或者 tuple.name int personAge tuple.Item2; // 或者 tuple.age4.2按名称解构如果解构目标使用了与元组元素相同的变量名可以省略赋值但顺序仍按当前位置匹配名称仅用于“匹配时隐式类型”的推导不是硬性要求名称一致。var tuple (name: Alice, age: 30); var (age, name) tuple; // ❗❗ 注意age 拿到 Alicename 拿到 30因为顺序匹配不是按名称匹配 //自动推断变量类型,等价于 var age tuple.name; var name tuple.age;4.3弃元Discard弃元Discard是 C# 中用下划线_表示的特殊变量意思是明确表示忽略这个值不使用它。无关名称只关顺序var (_, second) tuple;var tuple (name: Alice, age: 30, city: Beijing); // 只想要 name 和 age忽略 city var (name, age, _) tuple; // 只想要 name忽略后面两个 var (name, _, _) tuple; // 只要第二个元素 var (_, age, _) tuple;4.4核心结论顺序必须一致。解构变量的变量名可以与元组元素名不同。不要以为变量名和元组元素名相同就能自动忽略顺序——顺序永远优先名称只是 IDE 提示的辅助信息不是解构匹配的依据。5元组相等性比较两个元组比较是否相等会逐元素比较。两个元组如果结构相同且每个元素都相等则它们相等。var a (Name: 张三, Age: 30); var b (Name: 张三, Age: 30); Console.WriteLine(a b); // True逐元素比较6元组可以作为字典的KeyDictionaryTKey, TValue要求 Key 类型必须正确实现GetHashCode()—— 用于快速查找正确实现Equals()—— 用于判断相等ValueTuple已经内置实现了这两者// 创建一个以二维坐标为 Key 的字典 var map new Dictionary(int X, int Y), string(); //字典的键是个元组形式 // 添加数据 map[(0, 0)] 起点; map[(1, 2)] 宝箱; map[(5, 5)] Boss; // 访问 Console.WriteLine(map[(1, 2)]); // 输出: 宝箱 // 检查是否存在 if (map.ContainsKey((1, 2))) { Console.WriteLine(坐标 (1,2) 有东西); }7元组作为返回值这是元组最实用的场景之一让一个方法返回多个值而不需要创建专门的类或使用out参数。7.1无标签版// 返回两个整数无标签 static (int, int) GetMinMax(int[] numbers) { int min numbers.Min(); int max numbers.Max(); return (min, max); // 返回元组 } // 调用 var result GetMinMax(new int[] { 3, 1, 4, 1, 5, 9 }); Console.WriteLine($最小值: {result.Item1}, 最大值: {result.Item2});7.2有标签版// 返回时带标签调用方可以直接用字段名 static (int Min, int Max) GetMinMax(int[] numbers) { int min numbers.Min(); int max numbers.Max(); return (Min: min, Max: max); // 左边标签与右边标签一致 } // 调用 var result GetMinMax(new int[] { 3, 1, 4, 1, 5, 9 }); Console.WriteLine($最小值: {result.Min}, 最大值: {result.Max}); // 也可用 Item Console.WriteLine($最小值: {result.Item1}); // 同样有效