ConcurrentDictionary不是线程安全的Dictionary替代品，而是为特定并发模式设计的独立类型；其单个方法原子，但ContainsKey+赋值等组合操作存在竞态，须改用TryAdd、AddOrUpdate等专用方法，否则仍会出bug。
ConcurrentDictionary 不是 Dictionary 的线程安全平替，它只保证单个方法调用的原子性；组合操作（比如先查再写）必须换用 TryAdd、AddOrUpdate 等专用方法，否则照样出竞态 bug。
ConcurrentDictionary.TryAdd 为什么比 ContainsKey + 赋值安全
ContainsKey 返回 true/false 是线程安全的，但它的返回值一旦出来，就和后续操作脱钩了。两个线程同时执行 if (!dict.ContainsKey("x")) dict["x"] = val;，可能都通过检查，然后都赋值——后一个覆盖前一个，且无法感知。
-
TryAdd是单次原子调用：内部完成“查键不存在 + 插入”，失败时返回false，不抛异常 - 适用于“有则不管、无则新建”的典型场景，比如缓存预热、首次注册用户
- 如果需要“有则更新”，别硬拼逻辑，直接跳到下个副标题
AddOrUpdate 参数顺序错会导致旧值被无视
签名是 AddOrUpdate(TKey, Func<TKey, TValue>, Func<TKey, TValue, TValue>)，即：第二个参数是“新增工厂”（只传 key），第三个是“更新函数”（传 key 和 oldValue）。传反了，或把更新逻辑塞进第二个位置，结果就是每次调用都走新增分支。
- ❌ 错误：
dict.AddOrUpdate("k", (k, v) => v * 2, _ => 42)—— 第二个参数接收两个参数，编译都过不去 - ✅ 正确：
dict.AddOrUpdate("k", _ => 42, (k, old) => old * 2)—— 不存在时设为 42，存在时翻倍 - 如果只是想“存在就覆盖”，用
dict["k"] = newValue更简洁，它本身线程安全
GetOrAdd 工厂函数可能重复执行，Lazy<T> 是标准解法
GetOrAdd 保证最终只有一个值被存入，但不保证工厂函数只执行一次。多个线程同时发现 key 缺失，会各自触发一次工厂函数——HTTP 请求发三遍、数据库连接建三次，都是真实踩过的坑。
- 常见错误写法：
dict.GetOrAdd("cfg", _ => LoadConfigFromDb()) - 推荐写法：
dict.GetOrAdd("cfg", _ => new Lazy<Config>(() => LoadConfigFromDb())) - 后续使用时取
.Value，Lazy<T>内部已做线程安全初始化，只执行一次 - 注意：不要在工厂函数里写副作用逻辑（如写日志、发通知），除非你明确接受可能重复执行
遍历时不能删元素，TryRemove + 预收集 key 是唯一安全路径
对 ConcurrentDictionary 做 foreach 是安全的，它返回的是某个时间点的快照；但只要在循环体内调用 TryRemove 或 Clear，运行时大概率抛 InvalidOperationException。
- ❌ 危险：
foreach (var kvp in dict) { if (kvp.Value.IsExpired) dict.TryRemove(kvp.Key, out _); } - ✅ 安全：
var keysToRemove = dict.Where(kvp => kvp.Value.IsExpired).Select(kvp => kvp.Key).ToArray(); foreach (var key in keysToRemove) dict.TryRemove(key, out _); - 这个模式看似多了一步，但它是唯一能避免枚举中断的通用做法
真正容易被忽略的不是语法，而是思维惯性：总想把 ConcurrentDictionary 当成“加了锁的 Dictionary”来用。它不是。它的每个 API 都对应一种明确的并发意图，选错方法，线程安全就只剩个名头。
