DistinctBy 是 .NET 6+ 引入的 LINQ 扩展方法,用于根据键选择器对序列去重;.NET 5 及更早版本不支持,需用 GroupBy + First 等方式替代。
DistinctBy 是什么,.NET 版本要求是多少
DistinctBy 是 LINQ 提供的扩展方法,用于根据指定键选择器(如对象的某个属性)对序列去重。它不是 .NET Framework 或早期 .NET Core 的原生 API,而是从 .NET 6 开始引入 的新方法,位于 System.Linq 命名空间中。
- 如果你用的是 .NET 5 或更早版本,直接调用
DistinctBy会编译失败,提示“未找到定义” - .NET 6+ 项目可直接使用,无需额外 NuGet 包
- 如果无法升级框架,需手动实现等效逻辑(见下节)
不支持 DistinctBy 时怎么替代:用 GroupBy + First 或 ToLookup
在 .NET 5 及以前,常见替代方式是组合已有 LINQ 方法。注意这不是性能最优解,但语义清晰、兼容性强:
-
list.GroupBy(x => x.Id).Select(g => g.First())
简单直观,但会遍历整个分组(哪怕只要第一个元素),内存开销略高 -
list.ToLookup(x => x.Name).Select(g => g.First())
内部构建哈希表,适合多次查询同一键;单次去重不如GroupBy直观 -
自定义 IEqualityComparer 配合
Distinct
更底层、更灵活,但写法冗长,容易出错(比如 GetHashCode 实现不一致导致去重失效)
示例场景:对 List 按 Name 去重
var unique = people.GroupBy(p => p.Name).Select(g => g.First()).ToList();
DistinctBy 的正确用法和常见陷阱
DistinctBy 接收一个键选择器函数,返回首个匹配键的元素,后续相同键的元素被跳过:
- 正确写法:
list.DistinctBy(x => x.Category) - 错误写法:
list.DistinctBy(x => x.Category.ToString())(多余 ToString 可能掩盖 null 异常)
注意事项: