KeyValuePair 是只读结构体，专为字典遍历设计；foreach 遍历 Dictionary 时必须返回它，因 Enumerator.Current 类型契约固定，且其零装箱性能不可替代。
KeyValuePair 不是通用容器，它是只读结构体，专为字典遍历和轻量键值封装设计；直接 new 它不如用元组或 record 灵活，但 foreach 遍历 Dictionary 时你根本绕不开它。
为什么 foreach 遍历 Dictionary 得到的是 KeyValuePair 而不是匿名对象
因为 Dictionary<tkey>.Enumerator.Current</tkey> 的返回类型就是 KeyValuePair<tkey></tkey>，这是 .NET 运行时契约，不是语法糖。C# 的 foreach 会严格按集合的 IEnumerator.Current 类型推导迭代变量类型。
- 写
foreach (var kvp in dict)时，kvp实际类型就是KeyValuePair<string int></string>（假设字典是Dictionary<string int></string>） - 不能写
foreach (var (key, value) in dict)—— C# 7+ 元组解构不适用于KeyValuePair，它没有实现Deconstruct方法（.NET Core 3.0+ 才为KeyValuePair添加了Deconstruct，但旧项目或 TargetFramework 版本低时仍不可用） - 若强行用
(string key, int value)解构，编译器报错：Cannot deconstruct type 'KeyValuePair<string int>' because it contains no suitable Deconstruct method</string>
手动创建 KeyValuePair 的典型场景和坑点
手动 new KeyValuePair 多用于构建下拉框数据源、临时配对两个字段、或适配只接受 IEnumerable<keyvaluepair>></keyvaluepair> 的 API（比如某些控件的 DataSource）。
- 构造函数必须传入非空类型参数：例如
new KeyValuePair<int string>(1, "abc")</int>，不能省略类型参数（C# 9+ 支持目标类型推导，但需上下文明确，如赋值给已声明类型的变量） - 注意 null 引用：如果
TValue是引用类型，且值可能为null，要确保调用方能安全处理 ——KeyValuePair本身不做空检查 - 别把它当 DTO 用：它没有属性验证、无默认构造函数、不可变（
readonly struct），改 Key 或 Value 必须新建实例，不适合频繁更新的业务模型 - 示例（绑定 ComboBox）：
List<KeyValuePair<int, string>> items = new(); items.Add(new KeyValuePair<int, string>(1, "身份证")); items.Add(new KeyValuePair<int, string>(2, "护照")); cmb.DataSource = items; cmb.DisplayMember = "Value"; cmb.ValueMember = "Key";
ToString() 返回格式固定，别依赖它的字符串解析
KeyValuePair.ToString() 总是返回形如 "[key, value]" 的字符串，比如 new KeyValuePair<string, int>("test", 42).ToString() → "[test, 42]"。
- 这个格式是内部约定，未公开保证稳定，不应在日志分析、序列化或前端展示中硬编码解析逻辑
- 若需自定义输出，显式拼接：
$"Key={kvp.Key}, Value={kvp.Value}"，而不是kvp.ToString().Split(...) - 某些类型（如自定义类）的
ToString()可能返回空或不可读内容，导致最终字符串变成"[MyClass, ]"，排查时容易误判为KeyValuePair问题
性能与替代方案：什么时候该换掉 KeyValuePair
KeyValuePair 是 struct，栈上分配，遍历时零装箱开销 —— 这是它在字典枚举中不可替代的核心优势。但如果你的需求超出“读取一对值”，就该考虑别的东西。
- 需要可变性？用
DictionaryEntry（但它是 object/object，有装箱）或自定义 class - 需要多个字段？直接用元组：
(int Id, string Name, DateTime Created)，支持解构、更语义化 - 需要序列化/网络传输？用 record 或简陋 DTO 类，避免
KeyValuePair在 JSON 中被序列化成{"Key":..., "Value":...}这种无意义结构 - 注意：LINQ 的
Select若返回KeyValuePair，每次迭代都 new 一个 struct，虽快但语义模糊；不如select new { Key = ..., Value = ... }或命名元组
最常被忽略的一点：很多人以为 KeyValuePair 是“轻量级字典”，其实它连 IReadOnlyDictionary 都不实现，也没有查找能力 —— 它只是一个带两个 public readonly 字段的结构体，仅此而已。用错场景，后期维护成本远高于初期省的那几行代码。
