Distinct默认对引用类型按对象引用去重，需自定义比较逻辑；值类型和已重写Equals的引用类型（如string）可直接使用；按单字段用GroupBy+First，多字段用匿名类型+DistinctBy（.NET 6+）或GroupBy，复杂场景需实现IEqualityComparer。
Distinct 默认去重只适用于值类型或重写了 Equals/GetHashCode 的引用类型
直接对 List<person></person> 这类引用类型调用 .Distinct()，结果往往不是你想要的——它默认比较的是对象引用，不是字段内容。哪怕两个 Person 对象的 Name 和 Age 完全一样，也会被当成不同元素保留下来。
常见错误现象：.Distinct() 没生效，集合长度不变，或者调试时发现“明明一样却没去重”。
- 值类型（如
int、string）可直接用.Distinct() - 自定义类必须显式提供比较逻辑，否则默认行为不可靠
- 字符串是引用类型但已重写
Equals，所以List<string>.Distinct()</string>是安全的
按单个字段去重：用 GroupBy + First 最直观
不需要写比较器，也不用额外定义类，适合快速按 Id、Name 等唯一字段筛选“第一个出现的记录”。
示例：从 list 中取每个 CategoryId 第一次出现的 Product
var uniqueByCategory = list
.GroupBy(x => x.CategoryId)
.Select(g => g.First())
.ToList();
-
GroupBy分组后每组至少有一个元素，First()取首个，语义清晰 - 性能上比
Distinct+ 自定义比较器略低（需遍历并分组），但开发效率高、不易出错 - 如果想取“最新”的（比如按
CreatedTime最大的），把First()换成OrderByDescending(x => x.CreatedTime).First()
按多个字段去重：用匿名类型 + Distinct 最简洁
当需要同时基于 FirstName 和 LastName 去重时，匿名类型会自动实现结构相等比较，无需手写比较器。
示例：去除姓名重复的用户
var uniqueByName = users
.DistinctBy(u => new { u.FirstName, u.LastName })
.ToList();
⚠️ 注意：DistinctBy 是 .NET 6+ 新增的扩展方法（在 System.Linq 中），旧版本需用 GroupBy 替代：
var uniqueByName = users
.GroupBy(u => new { u.FirstName, u.LastName })
.Select(g => g.First())
.ToList();
- 匿名类型字段名和大小写必须一致，
new { F = u.FirstName }和new { FirstName = u.FirstName }不等价 - 字段值为
null时也能正确比较（匿名类型对null有安全处理） - 不支持动态字段数（比如“运行时传入字段名列表”），这种场景必须用自定义
IEqualityComparer<t></t>
自定义比较器：IEqualityComparer 是唯一可控方案
当需要复杂逻辑（如忽略大小写、按子字符串匹配、多级优先级判断）或兼容旧框架（.NET Framework / .NET 5-）时，必须实现 IEqualityComparer<t></t>。
示例：按 Code 字段忽略大小写去重
public class CodeComparer : IEqualityComparer<Product>
{
public bool Equals(Product x, Product y) =>
x?.Code?.Equals(y?.Code, StringComparison.OrdinalIgnoreCase) == true;
public int GetHashCode(Product obj) =>
obj?.Code?.ToLowerInvariant().GetHashCode() ?? 0;
}
使用：
var unique = products.Distinct(new CodeComparer()).ToList();
-
GetHashCode必须与Equals逻辑一致，否则Distinct可能漏判或误判 - 空值（
null）必须显式处理，否则NullReferenceException很容易发生 - 比较器实例可复用，不要每次调用都 new 一个——尤其在循环或高频路径中
最常被忽略的一点：Distinct 的执行是延迟的，但去重逻辑依赖于你提供的比较方式是否真正覆盖所有业务场景。比如按 Email 去重，却没考虑前后空格或大小写，数据就悄悄重复了。
