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 '*'