c# 字典 dictionary 用法_技术教程

安全取值应优先用 TryGetValue()，避免 KeyNotFoundException；添加键值对需据场景选 Add()（禁止覆盖）、索引器（允许覆盖）或 TryAdd()（仅首次添加）；预设容量可减少扩容开销；遍历无序，需排序或按插入顺序时应借助 LINQ 或其他集合。

怎么安全地取值？别再用 `dict[key]` 直接访问了

直接写 dict["user1"] 看似简洁，但只要键不存在，立刻抛出 KeyNotFoundException——线上服务一崩就是这个原因。真实项目里，键来源常来自用户输入、配置文件或数据库字段，根本不能假设“一定存在”。

✅ 推荐用 TryGetValue()：安全、高效、一行搞定
❌ 避免 ContainsKey() + dict[key] 两次查找：性能白丢一半
⚠️ GetValueOrDefault() 可用，但注意默认值是类型默认值（比如 int 是 0，string 是 null），容易掩盖逻辑错误

Dictionary userMap = new Dictionary { ["user1"] = "Alice" };
if (userMap.TryGetValue("user2", out string name))
{
    Console.WriteLine($"找到用户：{name}");
}
else
{
    Console.WriteLine("用户不存在");
}

添加键值对时，`Add()`、索引器、`TryAdd()` 到底该选谁？

三者行为完全不同，混用会导致逻辑混乱甚至数据丢失。

Add()：键已存在 → 立刻抛 ArgumentException；适合“严格不允许覆盖”的场景（如注册唯一ID）
索引器赋值（dict[key] = value）：键存在则覆盖，不存在则新增；适合缓存更新、状态快照等
TryAdd()（.NET Core 2.0+ / .NET 5+）：键不存在才添加，存在则静默失败并返回 false；适合并发初始化或“只设一次”的配置项

var config = new Dictionary(StringComparer.OrdinalIgnoreCase);
config.TryAdd("Timeout", "30");      // 成功
config.TryAdd("timeout", "60");      // 失败（忽略大小写，键已存在），返回 false
config["Timeout"] = "45";            // 强制覆盖为 45

为什么预设容量很重要？不是说字典能自动扩容吗？

能扩，但每次扩容都要重建整个哈希表：重新计算所有键的哈希值、重排 Entry[] 数组、复制数据——这会卡主线程，实测在万级数据插入时，不预设容量比预设慢 3–5 倍。

默认初始容量是 0（实际内部桶数组长度为 3），第一次 Add 就触发扩容
扩容策略是质数序列（如 3→7→13→29…），频繁扩容还会导致内存碎片
如果你知道大概要存 2000 条记录，直接写 new Dictionary(2048)

// ✅ 好习惯：按需预估，向上取最近的质数（或直接略大一点）
var userCache = new Dictionary(10_000);

// ❌ 别这样：让字典自己反复 realloc
var badCache = new Dictionary(); // 后续 Add 1w 次，至少扩容 10+ 次

遍历和排序：字典天生无序，想按插入顺序或 Key 排序得绕个弯

Dictionary 内部是哈希表，foreach 遍历顺序 ≠ 插入顺序，也 ≠ Key 大小顺序。这是高频误解点，尤其做导出、日志、调试时容易翻车。

要按插入顺序：改用 System.Collections.Generic.Dictionary 不行，得换 System.Collections.ObjectModel.KeyedCollection 或自行维护 List>
要按键排序：用 LINQ 的 OrderBy()（返回 IOrderedEnumerable，非字典）
要按值排序：同理，但注意值可能重复，Key 会丢失

var scores = new Dictionary { ["Bob"] = 85, ["Alice"] = 92, ["Charlie"] = 78 };

// 按 Key 字母序输出（注意：结果是新序列，不是字典）
var sorted = scores.OrderBy(kv => kv.Key);
foreach (var kv in sorted)
{
    Console.WriteLine($"{kv.Key}: {kv.Value}");
}
// 输出：Alice: 92, Bob: 85, Charlie: 78