todictionary要求键唯一，重复键抛argumentexception；常用三泛型重载，键不可为null，值可为空；重复键场景应选tolookup；空集合安全，但null元素或键选择器解引用null会异常。
ToDictionary 不是“自动转字典”的万能函数，它只接受键唯一的数据；一旦遇到重复键，立刻抛 ArgumentException，不给你留商量余地。
为什么 ToDictionary 一用就报 “An item with the same key has already been added”
这不是 bug，是设计强制校验：它底层调用的是 Dictionary<tkey tvalue>.Add()</tkey>，而该方法对重复键零容忍。常见诱因包括：
- 误把非唯一字段当键，比如用
p => p.City而不是p => p.Id - 数据库导出数据未清洗，同一
OrderId出现两次 - 前端传参或日志聚合时，原始集合已含重复项
快速定位重复键的写法：data.GroupBy(x => x.Key).Where(g => g.Count() > 1).Select(g => g.Key)。别急着改逻辑，先看清是哪几个键在撞车。
ToDictionary 的三个重载怎么选参数
最常用的是三泛型版本：ToDictionary<tsource tkey telement></tsource>，但实际使用中容易卡在参数类型上：
- 单参数版
source.ToDictionary(x => x.Id)：值默认为整个对象，等价于x => x，适合“键即标识、值即全量”的场景 - 两参数版
source.ToDictionary(x => x.Id, x => x.Name)：必须两个Func，缺一编译报错CS0411；注意第二个参数是函数，不是值（x.Name错，x => x.Name对） - 三参数版加
IEqualityComparer<tkey></tkey>：仅当键是自定义类（如Point）、或需忽略大小写（StringComparer.OrdinalIgnoreCase）时才需要，日常用不到
值可以为 null（引用类型），但键为 null 时，后续用 dict[null] 能取到，只是得确保你真需要这个行为。
ToDictionary 还是 ToLookup？关键看键是否允许重复
别凭感觉选。直接问自己：同一个键，源数据里会不会出现多次？
- 会 → 必须用
ToLookup，它返回ILookup<tkey telement></tkey>，天然支持一对多，lookup[key]返回的是IEnumerable<telement></telement>，要取第一个得写lookup[key].FirstOrDefault() - 不会 → 用
ToDictionary，支持dict[key]直接索引、TryGetValue安全取值、后续还能Add/Remove
ToLookup 不可修改，也不实现 IDictionary，所以别试图 (IDictionary)lookup 强转——编译不过。
性能和安全边界：空集合、null 元素、高频调用
空集合调用 ToDictionary 没问题，返回空字典；但只要某个元素为 null，且你的键选择器是 x => x.Name，就会在执行时抛 ArgumentNullException（键不能为 null 是字典契约）。
- 安全写法：
data.Where(x => x != null && x.Id != null).ToDictionary(x => x.Id, x => x) - 高频调用（如 Web API 每次请求都建）务必预估容量：
data.ToDictionary(x => x.Id, x => x, new Dictionary<int item>(data.Count))</int> - 如果只查一两次，别急着建字典——
list.FirstOrDefault(x => x.Id == target)配合合理索引，可能更快更省内存
真正容易被忽略的点：ToDictionary 是立即执行 + 全量加载，它不会帮你流式处理；如果你的数据来自 IAsyncEnumerable 或分页结果，别直接套用，得先 ToListAsync() 或手动累积。
