C#如何遍历字典Dictionary_C#键值对高效循环方式【基础】-C#.Net教程-PHP中文网

最安全直接的方式是用 foreach 遍历 dictionary，它调用 getenumerator() 保证结构稳定；避免 for 循环索引访问和在遍历中修改字典，linq 的 first/single 仍会全量扫描，需警惕隐式装箱和调试器显示延迟。

c#如何遍历字典dictionary_c#键值对高效循环方式【基础】

用 foreach 遍历 Dictionary 最安全

直接用 foreach 遍历 Dictionary<string int></string> 是最常用也最不容易出错的方式，它底层调用的是 GetEnumerator()，保证遍历时结构稳定，不会因修改字典引发 InvalidOperationException（除非你在循环体内主动改字典）。

常见错误现象：有人试图用 for (int i = 0; i 配合 <code>dict.Keys.ElementAt(i)，这不仅慢（ElementAt 是 O(n)），而且每次调用都重建枚举器，性能差、语义不清。

推荐写法：foreach (var kvp in dict) → 得到 KeyValuePair<tkey tvalue></tkey>，可直接访问 kvp.Key 和 kvp.Value
如果只关心值：foreach (var value in dict.Values)，比先取 kvp.Value 略快（省去 KeyValuePair 对象构造开销）
如果只关心键：foreach (var key in dict.Keys)，但注意 Keys 是只读集合，不能用于删除或修改

需要修改字典时必须先收集要操作的键

在遍历过程中直接调用 dict.Remove(key) 或 dict[key] = newValue 会触发“集合被修改”异常 —— 这不是 bug，是 .NET 的安全机制。哪怕只是 dict.ContainsKey(key) 再删，只要中间没缓存状态，依然可能出问题。

正确做法是把要删/改的键先存起来，再统一处理：

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

var keysToRemove = new List<string>();
foreach (var kvp in dict)
{
    if (kvp.Value 
<ul>
<li>不建议用 <code>ToList()</code> 直接转成列表再遍历（如 <code>dict.ToList().ForEach(...)</code>），因为 <code>ToList()</code> 会复制全部<a style="color:#f60; text-decoration:underline;" title="键值对" href="https://m.php.cn/zt/49710.html" target="_blank">键值对</a>，内存和时间成本双高</li>
<li>如果逻辑复杂、需多次判断，用 <code>Where(...).Select(...).ToArray()</code> 也比边遍历边改更清晰可控</li>
<li>注意：<code>dict.Keys.ToList()</code> 和 <code>dict.ToList()</code> 效率不同，前者只复制键，后者复制整个 KeyValuePair</li>
</ul>
<h3>性能敏感场景下避免 foreach 中访问 Key/Value 属性</h3>
<p>虽然 <code>KeyValuePair<tkey tvalue></tkey></code> 是 struct，但某些旧版 JIT（如 .NET Framework 4.7.2 前）对属性访问优化不足，反复调用 <code>kvp.Key</code> 和 <code>kvp.Value</code> 可能产生微小但可测的开销。这不是理论问题，在高频循环（如每秒百万次）中真实存在。</p>
<ul>
<li>简单优化：在 <code>foreach</code> 内部显式解构或赋值，例如 <code>var key = kvp.Key; var value = kvp.Value;</code>，后续逻辑全用局部变量</li>
<li>.NET 5+ 已大幅改善该问题，但若目标运行环境不可控（如客户私有部署的老版本），仍建议手动缓存</li>
<li>不要为了这点优化改用 <code>for</code> + <code>dict.Keys.ToArray()</code> —— 数组分配本身开销更大，且失去字典 O(1) 查找优势</li>
</ul>
<h3>别用 LINQ 的 ToList() 或 ToArray() 来“简化”遍历</h3>
<p>看到 <code>dict.ToList().ForEach(...)</code> 或 <code>dict.Where(...).ToList()</code> 就该警觉：这是典型用法误用。它看起来简洁，实则做了三件事：分配新数组、逐个拷贝所有元素、再遍历新容器 —— 完全抵消了 Dictionary 的核心优势。</p>
<p>典型错误场景：想过滤后批量处理，却写成：</p>
<pre class="brush:php;toolbar:false;">// ❌ 错误：无谓复制
dict.Where(x => x.Value > 100).ToList().ForEach(x => Process(x.Key, x.Value));

正确替代：foreach (var kvp in dict) { if (kvp.Value > 100) Process(kvp.Key, kvp.Value); }
如果后续还需复用结果，且数据量不大，才考虑 var filtered = dict.Where(...).ToArray()，但要明确这是空间换逻辑清晰度
特别注意：LINQ 的 Count()、Any() 在字典上虽有优化，但 First()、Single() 仍会全量扫描，别当 O(1) 用