如何编写仅适用于值为List的Dictionary的扩展方法？

核心思路 #

扩展方法的关键在于通过this关键字指定目标类型，我们直接把目标类型设为Dictionary<TKey, List<TValue>>，这样这个方法就只会出现在值为列表的字典实例上，不会干扰其他类型的字典。

完整代码示例 #

首先需要一个静态类来存放扩展方法（C#要求扩展方法必须在静态类中）：

public static class DictionaryListExtensions
{
    /// <summary>
    /// 向Dictionary的列表值中添加元素：键存在则追加，不存在则创建新列表并添加
    /// </summary>
    /// <typeparam name="TKey">字典的键类型</typeparam>
    /// <typeparam name="TValue">列表中的元素类型</typeparam>
    /// <param name="dict">目标字典</param>
    /// <param name="key">要操作的键</param>
    /// <param name="value">要添加的元素</param>
    /// <exception cref="ArgumentNullException">当字典或键为null时抛出</exception>
    public static void AddOrAppend<TKey, TValue>(this Dictionary<TKey, List<TValue>> dict, TKey key, TValue value)
    {
        // 空值检查，避免NullReferenceException
        if (dict == null)
            throw new ArgumentNullException(nameof(dict));
        if (key == null)
            throw new ArgumentNullException(nameof(key));

        if (dict.TryGetValue(key, out var existingList))
        {
            // 键已存在，直接向列表添加元素
            existingList.Add(value);
        }
        else
        {
            // 键不存在，创建新列表并加入字典
            var newList = new List<TValue> { value };
            dict.Add(key, newList);
        }
    }
}

使用方法 #

在你的代码中，只要引用了这个静态类所在的命名空间，就可以直接调用这个扩展方法：

// 创建一个键为字符串、值为整数列表的字典
var studentScores = new Dictionary<string, List<int>>();

// 添加第一个分数给学生"张三"
studentScores.AddOrAppend("张三", 90);
// 追加第二个分数给"张三"
studentScores.AddOrAppend("张三", 85);
// 给新学生"李四"添加分数（自动创建列表）
studentScores.AddOrAppend("李四", 95);

// 输出结果：张三的列表有90和85，李四的列表有95
foreach (var pair in studentScores)
{
    Console.WriteLine($"{pair.Key}: {string.Join(", ", pair.Value)}");
}

为什么这个方法只对Dictionary<T, List>生效？ #