C#怎么清空Dictionary_C# Clear方法与重新分配内存对比【底层】

在 .NET 里清空一个 Dictionary，大部分人下意识的做法要么是 Clear()，要么是 new 一个。两种方式都能达到“清空”的效果，但代价完全不同。核心结论其实很简单：绝大多数场景下，直接用 Clear() 是最优的选择——不是“可以”，而是“应该”。除非你明确观察到容量严重浪费且长期闲置，否则别轻易走 new 那条路。

Clear() 做了哪些事？它只重置状态，不碰底层数组

理解这点很关键。Clear() 内部只干两件事：把 _count 设为零，然后把 _entries 数组里所有键和值的字段清为默认值（default(TKey) / default(TValue)）。_buckets 和 _entries 这两个底层数组本身，依然原封不动地保留着。

这意味着什么？

• 后续再插入新元素时，完全不需要重新分配内存，也不需要扩容，直接复用已有的哈希表结构——这在频繁重填的场景下，性能优势是显而易见的。
• 如果一个字典曾经膨胀到 100 万的容量，Clear() 之后它仍然是 100 万。高频重填时这是优点，但如果长时间空置，就变成了内存浪费。
• 清空后，如果字典里储存的是大对象引用（比如 byte[]、List 之类的），这些对象在没有其他引用指向它们时，会立刻进入 GC 可回收状态。

new Dictionary() 的真实开销，远不止“多一次分配”那么简单

不少人习惯用 dict = new Dictionary() 来“清空”，他们觉得只是新建一个对象而已，没什么大问题。但实际触发的是连锁反应：

• 原字典对象——包括它那一整块 _entries 数组——会变成垃圾，等着 GC 来回收。在高频循环里，这种写法极容易推高 Gen0 的回收频率，造成的性能影响比想象中大得多。
• 新字典从初始容量开始起步（.NET 6+ 默认容量为 0，第一次 Add 时才分配质数大小的数组），后续插入可能连续触发多次扩容，每次扩容都要复制旧数据、重哈希，耗时又耗力。
• 实测数据很直观：3 万次循环里每次填充 1 万个元素，用 Clear() 耗时大约 6 秒，用 new 则飙升到 20 秒——差距主要来自扩容和 GC 压力。
• 如果想保留容量、又不想承受 GC 压力，可以写成 dict = new Dictionary(dict.Capacity)。但有个细节要注意：.NET 5 及之前版本不支持传 0 容量，最小值为 1。

遍历中调用 Clear()，直接崩给你看

这是最容易踩的坑，也是生产环境中常见的 runtime 陷阱。只要你在 foreach (var kv in dict) 或者 dict.Keys.GetEnumerator() 的迭代过程中，突然调用 Clear()，下一秒就会看到：

System.InvalidOperationException: Collection was modified; enumeration operation may not execute.

原因很直接：迭代器内部缓存了一个 _version 字段，Clear() 会递增这个版本号，导致版本校验失败，迭代器认为自己正在读的数据已经被动了，索性直接抛出异常。

安全替代方案只有两个：

• 确定不需要在遍历过程中做修改的，就别在遍历中间清空——等循环结束，再调 Clear()。
• 如果真有边遍历边清理的需求（比如按条件删除部分元素），那就先拷贝快照：dict.Keys.ToList() 或 dict.ToArray()，然后遍历这份快照去 Remove()。

多线程环境下，Clear() 必须加锁，或者换类型

Dictionary 本身就不是线程安全的。Clear() 也不是原子操作——它需要逐个归零 _entries、重置 _count、更新 _version。多个线程同时调用 Clear()，或者一个线程在 Clear() 时另一个线程正在 TryGetValue()，大概率会蹦出 NullReferenceException，或者返回一个错乱的结果。

简单加锁的话，有两点值得留意：

• 锁对象不应该用 dict 本身（它有可能被别人设为 null）。
• 推荐的做法是声明一个私有的只读对象字段，比如 private readonly object _dictLock = new object();。
• .NET 6+ 提供的 ConcurrentDictionary.Clear() 是真正线程安全的。不过要注意，.NET 5 及更早的版本中，这个方法只是“尽力而为”，仍然需要外部同步机制来保证安全。

容量残留和线程安全这两点，是生产环境里最容易忽略的细节。不要只盯着“数据清没清掉”，得看清楚“谁在读、读的是否一致、内存还剩多少”。