c#如何遍历字典中的key和value_c#遍历字典key和value详解

遍历字典的Key和Value：安全、高效与那些容易踩的坑

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

在C#编程中，高效地操作Dictionary是开发者必备的核心技能。其中，遍历字典以获取键值对是最常见的需求之一。然而，选择不当的遍历方法不仅会影响代码性能，还可能引发运行时异常。本文将深入探讨C#遍历字典的多种方法，对比其优缺点，并揭示那些容易被忽视的陷阱，帮助你写出更健壮、更高效的代码。

首选方案：用 foreach 遍历 KeyValuePair

这是最经典且最受推荐的遍历方式。它能在单次迭代中同时获取键（Key）和值（Value），避免了重复查找的开销，并且天然地规避了在遍历过程中直接修改字典可能引发的InvalidOperationException异常。当然，前提是你在循环体内没有执行添加、删除等修改操作。

以下是一个清晰的标准示例：

var dict = new Dictionary { ["a"] = 1, ["b"] = 2 };
foreach (var kvp in dict)
{
    Console.WriteLine($"{kvp.Key} -> {kvp.Value}");
}

这里有一个重要的技术细节需要注意：循环变量kvp的类型是KeyValuePair，它是一个结构体，而非匿名元组。因此，你不能直接使用C# 7.0及以上版本提供的元组解构语法var (key, value)，而必须显式地访问其Key和Value属性。

关于解构语法：需要一点额外转换

如果你偏爱var (key, value)这种简洁的解构写法，确实有方法可以实现，但需要额外的转换步骤。因为Dictionary的枚举器返回的是KeyValuePair对象，而非元组。

• 一种常见的做法是使用LINQ的Select方法进行投影转换：dict.Select(kvp => (kvp.Key, kvp.Value))。这会将序列中的每个元素转换为一个匿名元组。然而，这种方法引入了LINQ的延迟执行机制，并且每次迭代都会创建一个新的元组对象，带来微小的性能开销。
• 你也可以结合AsEnumerable()和Select来实现类似的效果。
• 从性能和代码清晰度的角度考虑，在许多场景下，直接使用kvp.Key和kvp.Value反而是更优的选择——它更直接、性能更好，并且避免了不必要的对象创建和潜在的装箱操作。

一个必须警惕的陷阱：遍历时修改字典

这是新手甚至经验丰富的开发者都容易犯错的地方。当一个Dictionary正在被foreach循环遍历时，如果在循环体内直接调用Add、Remove或Clear等修改集合结构的方法，运行时将立即抛出InvalidOperationException异常，并提示“Collection was modified”。

• 需要边遍历边删除怎么办？ 安全的做法是先收集需要删除的键，在遍历结束后再统一处理。例如：var keysToRemove = dict.Where(x => x.Value < 0).Select(x => x.Key).ToList(); keysToRemove.ForEach(dict.Remove);
• 需要边遍历边添加呢？ 建议使用一个新的临时字典来承接要添加的项。或者，可以考虑改用for循环，并配合dict.Keys.ToList()来获取键的副本进行遍历（注意：ToList()会复制一份键的集合，这会增加额外的内存消耗）。
• 多线程环境呢？ 即使在并发环境下只进行只读遍历，使用普通的Dictionary也可能遇到迭代器状态不可预测的问题，导致数据不一致或异常。此时，线程安全的ConcurrentDictionary才是正确的选择。

Keys 和 Values 属性：只适合特定场景

dict.Keys和dict.Values属性分别返回字典中所有键和所有值的只读视图。单独遍历它们本身是合法的，但需要注意两个关键点：首先，官方文档并未保证遍历Keys的顺序与遍历Values的顺序完全对应（尽管在当前的主流实现中通常是稳定的）；其次，它们只提供了单侧信息，丢失了键值对的关联性。

• 当你只需要处理所有的键时（例如，检查是否存在某个特定前缀的键），使用foreach (var key in dict.Keys)是完全合适且高效的。
• 但如果你需要根据键来获取对应的值，却选择先遍历Keys，再在循环内通过dict[key]进行索引查找，那么其性能将远低于直接遍历KeyValuePair。因为每次dict[key]都是一次独立的哈希查找，存在开销，并且如果键不存在，还会引发KeyNotFoundException异常。
• 遍历Values时同理：你完全丢失了键的上下文，无法进行反向查找，也不适用于任何需要键值配对处理的业务逻辑。

还有一个容易被开发者忽略的关键特性：在标准的Dictionary中，遍历顺序并不等于元素的插入顺序（即使在.NET Core 2.0+和.NET 5+的默认实现中也是如此）。如果你需要严格地按照插入顺序或某种特定的排序规则进行遍历，应当选择SortedDictionary、ImmutableSortedDictionary，或者自行维护一个List>来保证顺序。