RoslynClrHeapAllocationAnalyzer HAA规则速查表：从显式new到隐式分配的18条告警详解

RoslynClrHeapAllocationAnalyzer HAA规则速查表从显式new到隐式分配的18条告警详解【免费下载链接】RoslynClrHeapAllocationAnalyzerRoslyn based C# heap allocation diagnostic analyzer that can detect explicit and many implicit allocations like boxing, display classes a.k.a closures, implicit delegate creations, etc.项目地址: https://gitcode.com/gh_mirrors/ro/RoslynClrHeapAllocationAnalyzerRoslynClrHeapAllocationAnalyzer 是一款基于 Roslyn 的 C# 堆分配诊断分析器能检测显式 new 分配还能发现装箱、闭包display class、隐式委托创建等大量看不见的隐式分配。本文快速详解它的全部 18 条 HAA 告警规则是你做 C# 性能优化时的一页速查表。为什么需要堆分配分析器在热循环里每多分配一个小对象都要交给托管堆处理垃圾回收GC的压力随之增大性能自然下降。新手通常只知道new会产生对象但 C# 中还有很多看不见的分配字符串拼接每次拼接都会分配一个全新的字符串闭包捕获局部变量编译器会偷偷生成一个显示类来存放被捕获的变量值类型传给引用类型参数触发一次装箱boxingRoslynClrHeapAllocationAnalyzer 把这些隐藏的分配都变成编辑器里的告警让你在写代码阶段就能发现它们而不是等上线后再排查。获取方式可从 Visual Studio 扩展市场安装该分析器也可以在项目中直接引用 NuGet 包ClrHeapAllocationAnalyzer让告警在每次编译时自动出现。它还内置了代码修复能力例如提示你用Array.EmptyT()替换不必要的空数组/集合分配源码见ClrHeapAllocationsAnalyzer/AvoidAllocationWithArrayEmptyCodeFix.cs。HAA 编号怎么读18 条规则统一采用HAA 编号的格式中间两位代表分配类型直接对应分析器的源码文件编号前缀分配类型对应源码文件HAA01调用点隐式分配ClrHeapAllocationsAnalyzer/CallSiteImplicitAllocationAnalyzer.csHAA02字符串拼接分配ClrHeapAllocationsAnalyzer/ConcatenationAllocationAnalyzer.csHAA03闭包 / 显示类分配ClrHeapAllocationsAnalyzer/DisplayClassAllocationAnalyzer.csHAA04枚举器分配ClrHeapAllocationsAnalyzer/EnumeratorAllocationAnalyzer.csHAA05显式 new 分配ClrHeapAllocationsAnalyzer/ExplicitAllocationAnalyzer.csHAA06类型转换与委托分配ClrHeapAllocationsAnalyzer/TypeConversionAllocationAnalyzer.cs所有规则都属于Performance类别分两个严重级别Warning大概率存在真实分配建议处理Info信息级提示是否优化由你自行判断HAA 18 条告警速查表按类别1️⃣ 调用点隐式分配HAA0101 ~ HAA0102规则ID告警含义常见场景处理建议HAA0101params 参数导致数组分配向带params的方法传多个实参复用已有数组或改用显式数组参数HAA0102值类型上未重写的虚方法调用对 struct 调用非重写的虚方法会导致装箱或 constrained 指令改为普通方法2️⃣ 字符串拼接分配HAA0201 ~ HAA0202规则ID告警含义常见场景处理建议HAA0201隐式字符串拼接分配用或字符串插值频繁拼字符串改用StringBuilderHAA0202拼接时值类型被装箱把 int、枚举等拼进字符串循环内高频拼接时改用 StringBuilder3️⃣ 闭包与 Lambda 分配HAA0301 ~ HAA0303规则ID告警含义常见场景处理建议HAA0301闭包分配源头标出捕获了哪些变量Lambda 捕获了局部变量消除捕获改为传参或提前赋值HAA0302为捕获闭包生成显示类编译器生成一个类来持有捕获的变量重构为不捕获变量的写法HAA0303泛型方法中的 Lambda 分配委托实例在泛型方法里写 Lambda把 Lambda 移到泛型方法之外4️⃣ 枚举器分配HAA0401规则ID告警含义常见场景处理建议HAA0401引用类型枚举器导致堆分配对接口类型集合foreach直接用Array/SpanT或使用 struct 枚举器5️⃣ 显式 new 分配HAA0501 ~ HAA0506规则ID告警含义常见场景处理建议HAA0501显式 new 数组分配new int[10]缓存、复用数组HAA0502显式 new 引用类型分配new ListT()空集合可用Array.EmptyT()有内置代码修复HAA0503显式 new 匿名对象分配new { A 1 }改用具体的类型HAA0504隐式 new 数组创建分配对象初始化器隐式生成数组改用显式类型HAA0505集合初始化器分配new Listint { 1, 2 }预建常量数组复用HAA0506LINQ let 子句诱导的分配LINQ 查询里用let改写为select或常规循环6️⃣ 类型转换与委托分配HAA0601 ~ HAA0604规则ID告警含义常见场景处理建议HAA0601值类型转引用类型导致装箱把 int 传给object参数改用泛型规则信息里也会这样建议HAA0602struct 实例方法生成委托导致装箱用结构体实例方法创建委托改用静态方法或实例方法HAA0603方法组创建委托的分配把方法名直接传给委托参数缓存委托实例避免重复创建HAA0604只读场景下的方法组委托分配Info 级同 HAA0603 但为只读方法组仅作信息提示新手最该先处理哪几条实际项目里出现频率最高、收益最大的通常是这三类HAA0201 / HAA0202字符串拼接循环里的字符串拼接是最常见的隐形杀手换成StringBuilder即可立竿见影HAA0301 / HAA0302闭包热点代码中的 Lambda 捕获变量会被隐藏类吃掉分配重构为传参即可消除HAA0601 / HAA0602装箱值类型进出object边界都会装箱优先用泛型消除。✅ 小技巧Info级的 HAA05xx 规则会标出所有显式 new属于全景提示不必逐条处理重点看热路径即可。常见问题FAQ问.g.cs等生成代码会被告警吗不会。分析器会自动忽略.g.cs生成文件以及带[CompilerGenerated]特性的代码相关逻辑见ClrHeapAllocationsAnalyzer/AllocationRules.cs。问项目还在维护吗README 中说明该项目已归档其中的高影响分析器正在并入官方的 dotnet/roslyn-analyzers。对新手来说这是个好消息未来这些 HAA 规则有望随官方分析器直接使用。问告警太多从哪里入手建议按本文顺序处理先清 Warning 级HAA01、02、03、04、06再按需处理 Info 级HAA05并优先关注调用频繁的热路径方法。 把这张表收藏好下次在 Visual Studio 错误列表中看到HAA0xxx时你就能秒懂它的含义和处理方向了。【免费下载链接】RoslynClrHeapAllocationAnalyzerRoslyn based C# heap allocation diagnostic analyzer that can detect explicit and many implicit allocations like boxing, display classes a.k.a closures, implicit delegate creations, etc.项目地址: https://gitcode.com/gh_mirrors/ro/RoslynClrHeapAllocationAnalyzer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考