.net中没有alternatelookup类型，它只是对lookup的误称；lookup是只读多值映射，由tolookup构建，支持一键多值查询且查不到不抛异常，而dictionary为单值映射且索引器查不到会抛异常。
没有叫 AlternateLookup 的 .NET 类型，这是个常见误解——它既不是 C# 语言特性，也不是 System.Collections.Generic 或 System.Linq 中的类或方法。 你搜到的“AlternateLookup”大概率是某篇博客/文档里手写的辅助类、旧版自定义封装，或是把 Lookup<k v></k> 拼错/误译了。
Lookup 是什么？和 Dictionary 有什么根本区别？
Lookup<k v></k> 是 .NET 提供的只读多值映射结构，由 Enumerable.ToLookup() 构建，本质是 IEnumerable<igrouping v>></igrouping> 的缓存实现。它和 Dictionary<k v></k> 不是替代关系，而是解决不同问题：
-
Dictionary<k v></k>：每个键最多对应一个值，适合“查唯一结果”，如userById[123] -
Lookup<k v></k>：每个键可对应零个或多个值，适合“查所有匹配项”，如ordersByStatus["Pending"]返回全部待处理订单 -
Lookup不支持增删改，构造后不可变；Dictionary支持完整 CRUD -
Lookup的Contains和索引器访问不会抛异常（查不到返回空序列），而Dictionary索引器查不到会抛KeyNotFoundException
如何正确用 ToLookup 替代“多次 Where + GroupBy”低效查找？
典型场景：从大集合中反复按同一条件分组查询。直接每次 list.Where(x => x.Status == s).ToList() 是 O(n) 重复遍历；用 ToLookup 预计算一次，后续访问是 O(1) 均摊（内部用哈希表+链表）。
var orders = GetOrders(); // 假设 10k 条 // ❌ 每次都遍历全量 var pending = orders.Where(o => o.Status == "Pending").ToList(); var shipped = orders.Where(o => o.Status == "Shipped").ToList(); <p>// ✅ 一次性构建 Lookup，后续访问快且语义清晰 var lookup = orders.ToLookup(o => o.Status); var pending = lookup["Pending"].ToList(); var shipped = lookup["Shipped"].ToList(); </p>
-
ToLookup默认使用引用相等（EqualityComparer<tkey>.Default</tkey>），若键是自定义类，需重写GetHashCode/Equals或传入自定义IEqualityComparer<tkey></tkey> - 如果源集合后续会变，
Lookup不会自动更新——它是一次性快照 - 内存占用略高于
Dictionary<k list>></k>，因为要维护每组的迭代器状态
想手动模拟“可变的 Lookup”？别自己造轮子，用 Dictionary> 就够了
如果你真需要“能增删键值对的多值字典”，.NET 没提供现成类型，但没必要封装 AlternateLookup 这种名字误导人的类。直接用 Dictionary<string list>></string> 更直白、可控：
var dict = new Dictionary<string list>>
{
["Pending"] = new List<order>(),
["Shipped"] = new List<order>()
};
<p>// 添加
if (!dict.TryGetValue("Pending", out var list)) list = dict["Pending"] = new List<order>();
list.Add(new Order());</order></p>
<p>// 查询（安全）
if (dict.TryGetValue("Pending", out var pendingList))
foreach (var o in pendingList) { /<em> ... </em>/ }
</p></order></order></string>
- 避免用
dict[key].Add(...)直接索引——key 不存在时会抛异常；必须先TryGetValue或用GetOrAdd（.NET 6+ 的ConcurrentDictionary才有） - 如果并发修改，优先选
ConcurrentDictionary<k concurrentbag>></k>而非自己加锁封装 - 别为了“看起来像 Lookup”而用
Dictionary<k igrouping>></k>——IGrouping是只读接口，无法添加元素
真正容易被忽略的点是：很多人试图用 Lookup 解决本该用数据库索引或内存缓存（如 MemoryCache）的问题。它只是 LINQ 的一个便利投影工具，不是通用多值存储方案。数据量大、更新频繁、需要线程安全时，Lookup 就不该出现在生产代码里。
