BenchmarkDotNet 泛型基准测试实战:使用 [GenericTypeArguments] 为开放泛型 Benchmark 类注入类型参数

发布时间:2026/11/22 14:39:09

BenchmarkDotNet 泛型基准测试实战:使用 [GenericTypeArguments] 为开放泛型 Benchmark 类注入类型参数 BenchmarkDotNet 泛型基准测试实战使用 [GenericTypeArguments] 为开放泛型 Benchmark 类注入类型参数【免费下载链接】BenchmarkDotNetPowerful .NET library for benchmarking项目地址: https://gitcode.com/gh_mirrors/be/BenchmarkDotNet泛型 Benchmark 类是 C# 基准测试中常见的进阶场景但 BenchmarkDotNet 默认无法直接运行未闭合的泛型类型open generic type。本文以官方示例IntroGenericTypeArguments为主线讲解如何通过[GenericTypeArguments]特性为泛型 Benchmark 类指定一组或多组类型实参使同一套基准逻辑可以针对不同类型分别测量并深入仓库源码剖析其底层闭合机制、可重复特性用法以及内置 Roslyn 分析器的约束校验帮助读者写出可复制的多类型泛型基准测试。示例概述IntroGenericTypeArguments官方示例位于 samples/BenchmarkDotNet.Samples/IntroGenericTypeArguments.cs完整源码如下using BenchmarkDotNet.Attributes; namespace BenchmarkDotNet.Samples { [GenericTypeArguments(typeof(int))] [GenericTypeArguments(typeof(char))] public class IntroGenericTypeArgumentsT { [Benchmark] public T Create() Activator.CreateInstanceT(); } }该示例的核心思想非常简洁定义了一个开放泛型基准类IntroGenericTypeArgumentsT其中含有一个[Benchmark]标记的方法Create()Create()通过Activator.CreateInstanceT()创建类型T的实例并返回用于测量通过反射创建不同类型实例的开销类上通过两个[GenericTypeArguments]特性分别指定typeof(int)与typeof(char)表示将T分别闭合为int和char各跑一轮基准。运行后BenchmarkDotNet 会为该类生成两个独立的基准用例Benchmark CaseIntroGenericTypeArgumentsint.Create()与IntroGenericTypeArgumentschar.Create()分别输出各自的时间/内存统计结果。该示例对应的官方文档为 docs/articles/samples/IntroGenericTypeArguments.md其中以!code-csharp指令直接内嵌了上述源码并给出了指向该示例的永久链接BenchmarkDotNet.Samples.IntroGenericTypeArguments。特性定义GenericTypeArgumentsAttribute 的三种构造形式[GenericTypeArguments]特性的定义位于 src/BenchmarkDotNet.Annotations/Attributes/GenericTypeArgumentsAttribute.cs其关键声明如下[AttributeUsage(AttributeTargets.Class, AllowMultiple true)] public class GenericTypeArgumentsAttribute : Attribute { public Type[] GenericTypeArguments { get; } public GenericTypeArgumentsAttribute(Type type) { ... } // 单类型实参 public GenericTypeArgumentsAttribute(Type type1, Type type2) { ... } // 双类型实参 public GenericTypeArgumentsAttribute(Type type1, Type type2, Type type3) { ... } // 三类型实参 }从定义可以看出三个要点目标对象AttributeTargets.Class只能标注在类上Benchmark 类本身可重复AllowMultiple true允许在同一类上叠加多个[GenericTypeArguments]特性每个特性对应一组类型实参从而生成多组闭合后的基准参数个数构造函数提供 1 个、2 个、3 个Type三种重载分别对应泛型类型定义中T、T1, T2、T1, T2, T3三种常见情况。类型实参数必须与类的泛型参数个数一致否则无法成功闭合详见下文分析器校验部分。此外特性构造函数的Type参数均标注了[DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.All)]这是为 Native AOT / 裁剪场景保留类型元数据确保泛型实参类型在发布裁剪后仍能被反射完整访问。底层原理GenericBenchmarksBuilder 如何闭合泛型类型BenchmarkDotNet 会在发现基准类阶段将带[GenericTypeArguments]的开放泛型类型转换为可运行的具体闭合类型。核心实现位于 src/BenchmarkDotNet/Helpers/GenericBenchmarksBuilder.csinternal static Type[] GetRunnableBenchmarks(IEnumerableType types) types.Where(type type.ContainsRunnableBenchmarks()) .SelectMany(BuildGenericsIfNeeded) .Where(x x.isSuccess) .Select(x x.result) .ToArray(); internal static IEnumerable(bool isSuccess, Type result) BuildGenericsIfNeeded(Type type) { var typeArguments type.GetCustomAttributes(true).OfTypeGenericTypeArgumentsAttribute() .Select(x x.GenericTypeArguments) .ToArray(); if (typeArguments.Any()) return BuildGenericTypes(type, typeArguments); return [(true, type)]; } private static IEnumerable(bool isSuccess, Type result) BuildGenericTypes(Type type, IEnumerableType[] typeArguments) typeArguments.Select(genericArg (type.TryMakeGenericType(genericArg, out var builtType), builtType)); private static bool TryMakeGenericType(this Type type, Type[] typeArguments, out Type result) { try { result type.MakeGenericType(typeArguments); return true; } catch (ArgumentException) { result type; return false; } }整个流程可以拆解为四步过滤可运行类型ContainsRunnableBenchmarks()先排除抽象类再结合是否是开放泛型进行判断详见下文读取特性通过反射读取类上的所有GenericTypeArgumentsAttribute得到一组组类型实参数组逐一闭合对每组类型实参调用type.MakeGenericType(genericArg)把开放泛型类型定义如IntroGenericTypeArguments实例化为闭合类型如IntroGenericTypeArgumentsint失败兜底MakeGenericType在实参个数不匹配或实参约束不满足时会抛出ArgumentExceptionTryMakeGenericType将其捕获并标记isSuccess false后续Where(x x.isSuccess)会直接丢弃该组失败类型不会让整个运行崩溃。同时src/BenchmarkDotNet/Extensions/ReflectionExtensions.cs 中的ContainsRunnableBenchmarks与IsRunnableGenericType定义了什么样的泛型类是可达的internal static bool ContainsRunnableBenchmarks(this Type type) { var typeInfo type.GetTypeInfo(); if (typeInfo.IsAbstract || typeInfo.IsGenericType !IsRunnableGenericType(typeInfo)) return false; return typeInfo.GetBenchmarks().Any(); } private static bool IsRunnableGenericType(TypeInfo typeInfo) (!typeInfo.IsGenericTypeDefinition || typeInfo.GenericTypeArguments.Any() || typeInfo.GetCustomAttributes(true).OfTypeGenericTypeArgumentsAttribute().Any()) typeInfo.DeclaredConstructors.Any(ctor ctor.IsPublic ctor.GetParameters().Length 0);关键结论有两点一个未闭合的泛型类型定义IsGenericTypeDefinition为 true 且无已闭合实参只有在携带[GenericTypeArguments]特性时才会被视为可运行否则会被直接过滤掉——这解释了为什么示例类必须标注该特性无论是否泛型类都必须具备公共无参构造函数public且参数个数为 0因为 BenchmarkDotNet 需要以无参方式实例化基准类来执行每个[Benchmark]方法。多类型实参覆盖一参、两参、三参泛型GenericTypeArgumentsAttribute的三种构造函数覆盖了最常见的泛型元数arity。官方测试 tests/BenchmarkDotNet.Tests/GenericBuilderTests.cs 对这三种情况均有覆盖单类型实参与 IntroGenericTypeArguments 示例完全一致[GenericTypeArguments(typeof(int))] [GenericTypeArguments(typeof(char))] public class OneArgGenericBenchmarkT { [Benchmark] public T CreateT() Activator.CreateInstanceT(); }对应测试断言GetRunnableBenchmarks返回恰好 2 个类型且分别为OneArgGenericBenchmarkint与OneArgGenericBenchmarkchar。双类型实参[GenericTypeArguments(typeof(int), typeof(char))] [GenericTypeArguments(typeof(char), typeof(string))] public class TwoArgGenericBenchmarkT1, T2 { [Benchmark] public T1 CreateT1() Activator.CreateInstanceT1(); [Benchmark] public T2 CreateT2() Activator.CreateInstanceT2(); }三类型实参[GenericTypeArguments(typeof(int), typeof(char), typeof(string))] [GenericTypeArguments(typeof(char), typeof(string), typeof(byte))] public class ThreeArgGenericBenchmarkT1, T2, T3 { [Benchmark] public T1 CreateT1() Activator.CreateInstanceT1(); [Benchmark] public T2 CreateT2() Activator.CreateInstanceT2(); [Benchmark] public T3 CreateT3() Activator.CreateInstanceT3(); }由测试可以确认每组[GenericTypeArguments]是一组独立的类型实参组合N 个特性就会生成 N 个闭合类型每个闭合类型各自作为独立基准参与测量互不干扰。分析器约束编写时的编译期保护BenchmarkDotNet 提供了配套的 Roslyn 分析器src/BenchmarkDotNet.Analyzers其中的 BenchmarkClassAnalyzer.cs 定义了与泛型类型实参相关的两条诊断规则在编译期即可拦截错误用法ClassWithGenericTypeArgumentsAttributeMustBeGenericRule[GenericTypeArguments]只能标注在泛型类上。若把该特性放在非泛型类上分析器会直接报错因为类型实参无处可闭GenericTypeArgumentsAttributeMustHaveMatchingTypeParameterCountRule特性提供的类型实参数必须与类声明的泛型参数个数一致。例如类声明为T1, T2却只传了一个typeof(int)编译期即被标记为错误若在无分析器的环境下运行这一错误会落入GenericBenchmarksBuilder.TryMakeGenericType的ArgumentException捕获分支对应的闭合类型会被静默丢弃。这两条规则进一步印证了特性的使用契约泛型类 匹配数量的类型实参 公共无参构造函数三者缺一不可。运行与验证在仓库根目录下可通过以下方式运行该示例dotnet run -c Release --project samples/BenchmarkDotNet.Samples --filter *IntroGenericTypeArguments*运行结束后输出结果中会看到两组独立的结果行分别对应IntroGenericTypeArgumentsint与IntroGenericTypeArgumentschar两个闭合类型的Create基准各自包含 Mean、Error、StdDev 等统计列可用于比较同一段泛型代码在不同类型实参下的性能差异。若想在不启动完整基准运行的情况下验证泛型闭合逻辑本身可直接运行官方单元测试dotnet test tests/BenchmarkDotNet.Tests --filter FullyQualifiedName~GenericBuilderTestsGenericBuilderTests中的TestBuildGenericWithOneArgument、TestBuildGenericWithTwoArguments、TestBuildGenericWithThreeArguments三个测试用例分别验证了 1 参、2 参、3 参泛型在[GenericTypeArguments]驱动下的闭合结果数量与具体类型是与示例源码相互印证的底层行为测试。小结IntroGenericTypeArguments展示了 BenchmarkDotNet 中一套泛型基准逻辑、多组类型实参的标准做法用[GenericTypeArguments]可叠加为泛型 Benchmark 类声明一组或多组类型实参底层由 GenericBenchmarksBuilder 通过反射读取特性并调用MakeGenericType逐一闭合失败组合被安全跳过闭合后的每个类型成为一个独立基准用例与普通 Benchmark 类同等参与预热、迭代与统计编译期由 BenchmarkClassAnalyzer 的规则约束非泛型类不可用与实参个数必须匹配两类错误用法。对于需要在不同泛型实参如int/long/string/自定义结构体下重复测量同一算法实现的场景该特性是保持代码 DRY 且保证测量独立性的推荐方案。【免费下载链接】BenchmarkDotNetPowerful .NET library for benchmarking项目地址: https://gitcode.com/gh_mirrors/be/BenchmarkDotNet创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/22 17:39:32

车辆管理系统网站源码效果展示与实战解析

在车队规模扩张到几十辆甚至上百辆时,很多管理者会发现传统的 Excel 表格或简单的记账软件已经无法支撑日常运营了。车辆保养逾期、司机调度冲突、油耗异常波动这些问题往往在事后才被发现,导致运营成本居高不下。更棘手的是,当需要向管理层汇…

2026/11/23 2:48:23

电工证有哪些登记?内部消息告诉你怎么转异地

电工证有哪些登记?内部消息告诉你怎么转异地 之前考的证在外省能不能转过来?这几乎是每个在外打工的电工朋友都会遇到的问题。特别是像漯河这样的地方,在职建筑工人很多都是从外地过来的,手里拿着的电工证可能不是本地的。今天我就从 内部消息…

2026/11/23 2:48:23

电工考中级电工证怎么报?学历不高怕报不上名?上岗必备全解析

电工考中级电工证怎么报?学历不高怕报不上名?上岗必备全解析 你是不是也这样,看着电工岗位的高薪待遇眼馋,但又担心自己学历不够,连报名资格都达不到?别急,电工考中级电工证真的对学历没那么高要求,只要你符合基本条件, 上岗必备…

2026/11/23 2:48:23

工地太忙根本没时间复习考试?昌都电工证怎么复审千万别踩坑

工地太忙根本没时间复习考试?昌都电工证怎么复审千万别踩坑 工地太忙根本没时间复习考试?昌都电工证怎么复审千万别踩坑,你不是一个人。尤其是那些在工地上天天扛着工具、跑着送电的电工,哪有空去复习理论考试?但你敢说复审不通过,后果不严重?别急,我…

2026/11/23 2:43:22

特种工证是什么样的报考条件与考试时间多少钱

特种工证是什么样的报考条件与考试时间多少钱 之前考的证在外省能不能转过来?这个问题我见过太多施工队的老板问了,尤其是那些从外地过来承接项目的老手,动不动就拿着外地的特种工证过来咨询能不能在当地使用,或者能不能转到本地来。说实话, 多少钱…

2026/11/22 0:09:40

高压电工证还能年审吗良心建议来了,学历不高也能考!

高压电工证还能年审吗良心建议来了,学历不高也能考! 你是不是也担心,自己学历不高,根本报不上高压电工证?其实不然,现在政策已经非常明确, 高压电工证还能年审 ,而且只要符合条件, 学历不是门槛 , 良心建议…

2026/11/23 2:38:11

吴江的电工证免费培训怎么报名?官方报名入口全解析

吴江的电工证免费培训怎么报名?官方报名入口全解析 你急需特种作业证才能上岗找工作,但不知道从哪里下手?别急,现在就给你讲明白【吴江的电工证免费培训】到底怎么操作,以及怎么通过 官方报名入口…

2026/11/23 0:26:19

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱 不知道去哪报名怕被中介坑?这几乎是每个需要办理或复审电工证的人的真实经历。尤其在肃州区,信息不透明、流程复杂、中介收费高又不靠谱,让很多电工从业者感到头疼。作为一个在应急管理和特种作…

2026/11/23 0:01:38

南宁哪里可以学电工证值不值得考?怕被中介坑?看这篇就够了

南宁哪里可以学电工证值不值得考?怕被中介坑?看这篇就够了 不知道去哪报名怕被中介坑?南宁哪里可以学电工证值不值得考?这是很多想考电工证的朋友最关心的问题。现实中,不少人在选择培训机构时被各种五花八门的广告信息搞得晕头转向,甚至被坑了钱还没拿…

2026/11/23 0:01:38

建设局特种工证怎么查全国通用的复审流程

建设局特种工证怎么查全国通用的复审流程 证书过期了不知道怎么复审延期,这是很多特种作业从业者常遇到的问题。尤其是在洛阳涧西区从事水利工程工作的你,特种作业操作证不仅是上岗的“通行证”,更是保障安全作业的法律底线。如果操作证过期了,不仅影响工…

2026/11/23 0:01:38

电工证跨考政策值不值得考?学历不高也能考的真相

电工证跨考政策值不值得考?学历不高也能考的真相 你是不是也觉得学历不够,报电工证怕被拒?别急,国家安全生产考试网明文规定, 电工证跨考政策 对学历门槛没有硬性限制,只要你年满18岁,身体健康,能通过实操考试,就能报考。关键是, 值不值得考…

2026/11/22 9:39:14

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/22 5:39:03

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑