直接用含可变引用类型的tuple作字典键会导致静默查找失败，因其哈希码随对象修改而变化；应选用纯值类型、不可变引用类型或自定义readonly struct。
为什么直接用 Tuple 当字典键会出问题？
因为默认的 Tuple<t1 t2></t1> 类型虽然重载了 Equals 和 GetHashCode，但它的哈希码生成依赖字段值——这本身没问题；真正踩坑的是：如果你用了可变引用类型（比如 string 以外的自定义类、List<int></int>、甚至 new object()），而这些对象后续被修改了，字典就再也找不到它了。不是报错，是查不到，静默失败。
常见错误现象：dict.ContainsKey(tupleKey) 返回 false，哪怕你刚用同一个变量 dict[tupleKey] = value 插入过。
- 不要把含可变引用类型的
Tuple当作字典键（例如Tuple<string list>></string>） -
Tuple<int string bool></int>这种纯值/不可变类型组合是安全的 - 如果必须用引用类型，确保它是不可变的（如
string、ReadOnlySpan<char></char>，或你自己写的readonly struct）
Dictionary<tuple string>, decimal></tuple> 的正确初始化和访问方式
声明时写清楚泛型参数，别靠 var 隐式推导——否则容易误用成 ValueTuple（C# 7+ 默认语法），而 ValueTuple 和 Tuple 是两个不同类型，哈希行为也不同，混用会导致查不到。
实操建议：
- 显式 new
Tuple<int string>(123, "abc")</int>，而不是(123, "abc")（后者是ValueTuple） - 插入：
dict[new Tuple<int string>(123, "abc")] = 99.5m;</int> - 查询：
if (dict.TryGetValue(new Tuple<int string>(123, "abc"), out var val)) { ... }</int> - 避免反复构造新实例——把 key 提前存为变量复用，减少 GC 压力
性能对比：Tuple vs ValueTuple vs 自定义 struct 键
Tuple<...></...> 是引用类型，每次 new 都分配堆内存；ValueTuple<...></...> 是栈友好的值类型，更快更省，但它的 GetHashCode 在 .NET Core 2.1+ 才修复了某些边界哈希冲突问题（旧版可能重复率偏高）。
更稳的选择其实是轻量 struct：
public readonly struct OrderKey
{
public readonly int ProductId;
public readonly string Region;
public OrderKey(int productId, string region) => (ProductId, Region) = (productId, region);
public override int GetHashCode() => HashCode.Combine(ProductId, Region);
}
-
ValueTuple写法最简（(123, "abc")），但要注意运行时版本 -
Tuple兼容性最好（.NET Framework 4.0+ 都行），但有 GC 开销 - 自定义
readonly struct性能最好、语义最清晰，适合高频访问场景
多字段匹配时，别忽略 null 和大小写敏感性
比如用 Tuple<string string></string> 当键，其中一个是 null，另一个是 "ABC"，那么 new Tuple<string string>(null, "abc")</string> 和 new Tuple<string string>(null, "ABC")</string> 是两个不同键——string 的 Equals 默认是区分大小写的，且 null 比较是按引用判等，没问题；但如果你希望忽略大小写，就得自己封装逻辑。
- 不推荐在键里直接存原始
string做模糊匹配 - 如需忽略大小写，提前转成
.ToLowerInvariant()再进 tuple - 若字段可能为
null，确认业务是否允许——Tuple本身支持null，但字典查找时不会自动做空合并
最常被忽略的一点：元组键的字段顺序必须严格一致。交换 Tuple<string int></string> 和 Tuple<int string></int> 就是完全不同的类型，编译都过不去——但人眼容易看串，尤其复制粘贴时。
