调用 Average() 前必须确保集合非空且元素可数值化，否则抛 InvalidOperationException；对可空类型会自动忽略 null，EF 中翻译为 SQL AVG() 且行为一致。
用 Average() 前必须确保集合非空且元素可数值化
直接调用 Average() 时，如果源集合为空（Count == 0），会抛出 InvalidOperationException: Sequence contains no elements。这不是异常处理疏忽的问题，而是设计使然——LINQ 不对空序列做默认兜底（比如返回 0 或 null）。
常见错误写法：list.Average(x => x.Score) 在 list 为空或所有 x 为 null（且 Score 是可空类型）时都会崩。
- 对引用类型或可空值类型（如
int?），优先用AverageOrDefault()（需自行扩展，.NET 6+ 原生不提供）或手动判空 +DefaultIfEmpty() - 对非空值类型（如
int,double），仍需检查Any()，尤其当数据来自外部（DB 查询、API 响应）时不可信 - 若使用 Entity Framework，
Average()会被翻译成 SQL 的AVG()，此时数据库行为一致：空结果集返回NULL，EF 会映射为对应可空类型的null，不会抛异常 —— 但本地集合（IEnumerable）和查询表达式（IQueryable）行为不一致，这点极易混淆
Average() 对可空类型（int?, double?）的隐式过滤逻辑
当你传入 IEnumerable 并调用 .Average()，它**自动忽略所有 null 元素**，只对非空值求平均。这不是 bug，是规范行为，但常被误认为“漏算”。
例如：new int?[] { 1, null, 3 }.Average() 返回 2.0（不是 4/3 ≈ 1.33），因为 null 被跳过，分母是 2。
- 若业务要求“空值按 0 参与计算”，得先用
.Select(x => x ?? 0)转换，再Average() - 若要求“空值导致整个平均值无效”，则必须提前用
All(x => x.HasValue)校验 - 注意：对
decimal?同样适用该规则，但decimal.Average()返回decimal，而decimal?.Average()返回decimal?—— 返回类型由源泛型参数决定，别靠 IDE 提示猜
在 IQueryable（如 EF Core）中用 Average() 的 SQL 翻译陷阱
EF Core 将 Average() 翻译为 SQL AVG() 函数，但它对 null 的处理和 C# 端一致：数据库里 AVG() 也跳过 NULL。真正容易出错的是投影阶段。
典型坑点：context.Orders.Where(x => x.Status == "Done").Average(x => x.Total) 看似没问题，但如果 Total 是 decimal? 且部分记录为 NULL，SQL 层已过滤掉这些行 —— 但开发者可能误以为 C# 端还会二次处理。
- 避免在
Select后链式调用Average()，比如.Select(x => new { x.Id, x.Total }).Average(x => x.Total)—— EF 可能无法翻译，抛出InvalidOperationException: The LINQ expression could not be translated - 如需复杂计算（如加权平均），别硬塞进
Average()，改用Sum(x => x.Value * x.Weight) / Sum(x => x.Weight)，并确认分母不为零 - 调试时打开 EF 日志（
EnableSensitiveDataLogging），看生成的 SQL 是否真含AVG(...)，而不是被降级为客户端计算（ToList().Average()）
性能敏感场景下，Average() 比手写循环慢吗？
对纯内存集合（IEnumerable），Average() 内部确实是一次遍历，和手写 for 循环时间复杂度相同（O(n)）。但有两处隐藏开销：
- 装箱：对值类型集合（如
int[]），Average()接收IEnumerable，底层用枚举器，无装箱；但若误传object[]存数字，就会触发装箱，拖慢速度 - 枚举器创建 & 泛型约束检查：高频小集合（如每帧计算几十个数的均值）中，这部分开销可测出；此时直接用数组索引 +
for更稳 - 若已知集合是数组或
List，且非空，可考虑source.Sum() / (decimal)source.Count—— 避免Average()的空检查和类型转换逻辑，但务必自己保障分母非零
真正影响性能的往往不是 Average() 本身，而是上游数据源：比如对未索引的 DB 表全表扫一遍再算平均，瓶颈永远在 IO 和 SQL 执行，不在 .NET 这层。
