C# Dictionary<string,string>(IEqualityComparer<string>?)构造函数应用示例咨询

这个构造函数的核心作用是让你自定义Dictionary对字符串键的比较规则——默认的Dictionary<string, string>用的是字符串的默认相等逻辑（区分大小写、区分文化），但实际开发里很多场景需要打破这个默认规则，这时候就该它出场了。

适用场景 #

• 大小写不敏感的键匹配：比如处理用户输入的搜索关键词、配置项名称，不管用户输入大写还是小写，都要匹配到同一个值
• 忽略特定字符的键比较：比如忽略键首尾的空格、中间的下划线/连字符，把"user_name"和"user name"、" UserName "视为同一个键
• 特定文化的字符串比较：比如在多语言场景下，按照目标语言的规则比较（比如法语中"café"和"cafe"视为相等）

示例代码 #

1. 默认行为（对比用） #

默认的Dictionary区分大小写，下面的代码会因为键重复报错：

var defaultDict = new Dictionary<string, string>();
defaultDict.Add("Apple", "苹果");
// 执行这行会抛出ArgumentException，因为"apple"和"Apple"被视为不同键
// defaultDict.Add("apple", "苹果");
Console.WriteLine(defaultDict.ContainsKey("Apple")); // 输出 True
Console.WriteLine(defaultDict.ContainsKey("apple")); // 输出 False

2. 现成的大小写不敏感比较器 #

直接用.NET内置的StringComparer.OrdinalIgnoreCase就能实现大小写无关的键匹配：

var caseInsensitiveDict = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
caseInsensitiveDict.Add("Apple", "苹果");
// TryAdd返回false，因为比较器认为"apple"和"Apple"是同一个键
caseInsensitiveDict.TryAdd("apple", "苹果");
Console.WriteLine(caseInsensitiveDict["apple"]); // 输出 "苹果"
Console.WriteLine(caseInsensitiveDict.ContainsKey("APPLE")); // 输出 True

3. 自定义比较器（忽略首尾空格） #

如果需要更个性化的规则，比如忽略键的首尾空格，可以自己实现IEqualityComparer<string>：

// 自定义比较器类
public class IgnoreWhiteSpaceComparer : IEqualityComparer<string>
{
    public bool Equals(string? x, string? y)
    {
        if (x == null && y == null) return true;
        if (x == null || y == null) return false;
        // 去掉首尾空格后比较，若要同时忽略大小写，可改成 x.Trim().Equals(y.Trim(), StringComparison.OrdinalIgnoreCase)
        return x.Trim() == y.Trim();
    }

    public int GetHashCode(string? obj)
    {
        if (obj == null) return 0;
        // 基于处理后的字符串生成哈希码，保证Equals返回true的字符串哈希码一致
        return obj.Trim().GetHashCode();
    }
}

// 使用自定义比较器
var ignoreSpaceDict = new Dictionary<string, string>(new IgnoreWhiteSpaceComparer());
ignoreSpaceDict.Add("  UserName  ", "张三");
Console.WriteLine(ignoreSpaceDict["UserName"]); // 输出 "张三"
Console.WriteLine(ignoreSpaceDict.ContainsKey("  username  ")); // 输出 False（若要支持大小写，需修改Equals方法）

内容的提问来源于stack exchange，提问作者Satish Chandra