C# Dictionary 使用指南：从泛型定义到线程安全，全面解析核心用法与最佳实践
Dictionary 初始化时必须指定泛型类型
在 C# 中直接声明 new Dictionary() 会导致编译失败。Dictionary 是一个强类型的泛型集合，必须明确指定键（TKey）和值（TValue）的具体类型。例如，创建字符串到用户对象的映射，应写作 new Dictionary。避免使用 new Dictionary() 或 new Dictionary 这类写法，后者虽能编译，但会破坏类型安全并引发不必要的装箱拆箱性能损耗。
未指定泛型参数通常会引发编译错误 CS0305，或在运行时抛出 InvalidCastException 类型转换异常。
- 键类型的选择原则：推荐使用不可变且已正确实现
GetHashCode()与Equals()方法的类型作为键，例如string、int、Guid等，这些是理想的字典键类型。 - 自定义类作为键的注意事项：若使用自定义类作为键，必须重写
GetHashCode()和Equals()方法，否则字典将基于对象引用进行相等性比较，导致查找逻辑错误。 - 避免使用可变键：切勿使用内容可变的引用类型（如未重写相关方法的
List）作为键。键值一旦被修改，其哈希码可能改变，导致该键在字典中无法被正确检索。
添加和查找键值对必须注意 KeyNotFoundException
通过索引器直接访问值，如 dict[“abc”]，是常见的错误用法。若键“abc”不存在，程序将抛出 KeyNotFoundException 异常，而非返回 null 或默认值。这在不确定键是否存在的业务场景中风险极高。
正确的字典值获取方式主要分为以下三种情况：
- 场景一：明确知道键存在。可直接使用
dict[key]，这种方式最为简洁且性能最佳，但前提是程序逻辑必须确保该键已被添加。 - 场景二：不确定键是否存在，且需要获取对应值。强烈推荐使用
dict.TryGetValue(key, out value)方法。它返回一个布尔值指示查找是否成功，并通过out参数返回找到的值。这种方法避免了异常抛出，且经过性能优化，是兼顾安全与效率的首选。 - 场景三：仅需判断键是否存在，无需获取值。可使用
dict.ContainsKey(key)方法。但需注意，其内部可能执行额外的哈希计算，通常比TryGetValue略慢。若非仅需判断存在性，更推荐使用TryGetValue。
以下是一个典型的安全取值示例：
if (users.TryGetValue(“U1001”, out var user))
{
Console.WriteLine(user.Name);
}
else
{
Console.WriteLine(“用户不存在”);
}
遍历 Dictionary 推荐用 foreach + KeyValuePair 而非 Keys/Values 分离
在需要同时遍历键和值时，应避免使用 foreach (var key in dict.Keys) { var val = dict[key]; ... } 这种模式。其问题在于，对每个键都会执行两次哈希查找（一次在 Keys 集合中，一次通过索引器），造成不必要的性能开销，且在并发修改时可能引发错误。
更高效且优雅的做法是直接遍历字典本身，它会返回一系列 KeyValuePair 结构体：
- 标准遍历写法：使用
foreach (var kvp in dict)，然后通过kvp.Key和kvp.Value访问键值对。这是最清晰、最常用的方式。 - 解构遍历写法（C# 7及以上）：若追求代码简洁，可使用元组解构语法：
foreach (var (id, user) in dict)。这种方式要求键值类型明确，使代码意图一目了然。 - 应避免的写法：不要为了遍历而调用
dict.Keys.ToList()或类似方法。这会创建不必要的中间集合，导致额外的内存分配，并丢失字典原有的结构语义。
Dictionary 不是线程安全的，多线程读写必须加锁或换 ConcurrentDictionary
这是一个关键的安全警告：标准的 Dictionary 类不是线程安全的。当多个线程同时执行添加、删除或某些读取操作时，可能导致其内部数据结构损坏，进而引发 InvalidOperationException 异常或返回错误数据。即使是“读多写少”的场景，只要存在任何写操作，就必须对普通 Dictionary 进行同步保护。
请注意，即便只是并发读取，在字典内部因容量不足而触发扩容重建时，也可能导致不可预知的问题。
处理多线程并发访问字典，主要有两种主流方案：
- 手动同步（使用锁）：使用
lock语句块包裹所有对字典的读写操作。建议使用一个私有的、只读的对象作为锁对象，避免直接锁定this或字典实例本身，以降低死锁风险。 - 使用线程安全集合：直接替换为
ConcurrentDictionary。该类内部采用了更精细的锁机制（如分段锁），使得大多数读操作可以无锁进行，写操作的锁竞争也更小，性能更优。但需注意，其GetOrAdd、AddOrUpdate等方法接收的工厂委托可能会被多次执行，因此不应在委托内编写具有副作用的逻辑。
