Table of Contents

Layout 显式布局基线

数字权威基线——快照非编年史;引用不复制。

环境

项 值
CPU / 内存 i5-12400 / 31.7 GB
OS / 运行时 Windows 11 专业版 26200 / .NET 8.0.422
框架 BenchmarkDotNet 0.14.0,Release,3 暖 15 测
采集日 2026-10-12

配置

  • 语料:显式布局结构(uint/ushort/ulong/int/long/byte 六字段,ValidEquals/ValidRange 校验)。
  • 对照基线 = 手工 BinaryPrimitives 逐字段写(同字段序同小端——手写即上限参照)。

数字

场景 Mean 分配
手工 BinaryPrimitives 逐字段写 2.16 ns 0 B
Codec.Write(无校验) 0.60 ns(Ratio 0.28) 0 B
Codec.Write + Validate 0.46 ns(Ratio 0.21) 0 B
Codec.Read 0.55 ns 0 B
Codec 往返(Write+Read) 2.13 ns 0 B

现状选型建议

  • typed Codec 全链零分配且快于手写逐字段(JIT 对编译期 switch 直访的展开优于手写 API 调用序)—— "显式布局零成本" 成立;校验开启无额外可测成本。
  • OrFlags/IsEmpty 维度暂缺(生成器 analyzer 引用缺陷立案中——见 validation-program-design 跟进),修复后回补。

复现

dotnet run --project benchmarks/KernLab.Loom.Layout.Benchmarks -c Release -- --filter '*'