use crate::bench::metrics::MetricCollection; /// 把结果序列化为美观 JSON 字符串。 pub fn format_json(results: &[MetricCollection]) -> String { serde_json::to_string_pretty(results).unwrap_or_else(|e| format!("{{\"error\": \"{}\"}}", e)) } /// 内存基准用例(`mem_*` 前缀)的留存形态说明,随表格尾部输出。 const MEMORY_BENCH_NOTES: &str = "\n内存基准用例(mem_*):\n mem_object_graph 大型对象图留存:15 层满二叉树 32767 节点整体驻留 session 堆 mem_string_accum 字符串累积留存:40000 个互不相同的字符串驻留数组(interner 压力) mem_closure_chain 闭包/upvalue 长链:10000 层闭包各自捕获前层闭包与 payload 驻留 mem_array_grow 数组增缩容量:扩到 200000 元素后截回 1000,观测元素向量容量是否回落(账目按 Vec capacity 计) mem_cross_call_retain 跨调用长存活数据:全局 store 经 30000 次调用累积 30000 条记录 mem_map_retain 原生盒边持有:Map 持 20000 组字符串键 + 对象值 mem_set_retain 原生盒边持有:Set 持 20000 个对象(各带 payload 字符串) mem_string_rope 拼接 rope 链留存:重复二元拼接形成深 Cons 链(账目按逻辑长度计,数值高于实际足迹) 口径:Peak B/Ret B 为 session 堆账目(对象头 + 堆数据 + 存活串);BigInt 不入 该账目,由单 run 分配公式按表长单列。epoch arena 的临时驻留不计入字节账目 (数量列恒零)。Peak B 为顶层指令边界采样的 session 堆账目高水位;单指令内瞬态 与 epoch 高水位不计。Ret B 为 workload 后晋升 + 完整 GC 的真存活集,至多含一份 引擎内部副本:逃逸屏障留 epoch 原件且顶层寄存器根不回写时,测量时晋升会把原件 再克隆一份(object_graph 见留存锚测试)。 "; /// A/B 判据口径说明,随表格尾部输出。 const BENCH_JUDGMENT_NOTES: &str = "\nA/B 判据口径:\n 主判(回归门):确定性列——指令数、内存账目(session/peak/retained)、 垃圾回收计数、内联缓存计数——跨运行逐字节一致,零容差,双向任何变化即信号; 基线对比的退出码 1 只认这些列。 次判(墙时间):wall/exec/compile/gc_collection 列在 ±5% 带内(固定核、 warmup 2、三轮中位);基线对比容差 0.50,信息性,不影响退出码。 基线文件是陈旧锚(安静树单次快照),不是 A/B 仪器;A/B 是同机同宿主 严格交错对比。 "; /// 把结果格式化为对齐的文本表格(供终端打印)。 /// /// `Sess B`/`Peak B`/`Ret B` 为 session 堆账目(字节):执行期累计 / 峰值高水位 / /// workload 后强制 GC 的存活留存。 pub fn format_text_table(results: &[MetricCollection]) -> String { let mut out = String::new(); out.push_str(&format!( "{:<35} {:>10} {:>10} {:>10} {:>12} {:>8} {:>8} {:>10} {:>10} {:>10} {:>10}\n", "Test Name", "Wall(ms)", "Comp(ms)", "Exec(ms)", "Instrs", "GC Ct", "IC Rate", "Sess Objs", "Sess B", "Peak B", "Ret B", )); out.push_str(&"-".repeat(150)); out.push('\n'); for m in results { out.push_str(&format!( "{:<35} {:>10.2} {:>10.3} {:>10.3} {:>12} {:>8} {:>7.1}% {:>10} {:>10} {:>10} {:>10}", truncate(&m.test_name, 35), m.wall_time_us as f64 / 1000.0, m.compile_time_us as f64 / 1000.0, m.exec_time_us as f64 / 1000.0, m.instruction_count, m.gc_trigger_count, m.ic_hit_rate * 100.0, m.session_objects, m.session_bytes, m.peak_bytes, m.retained_bytes, )); out.push('\n'); } out.push_str(MEMORY_BENCH_NOTES); out.push_str(BENCH_JUDGMENT_NOTES); out } fn truncate(s: &str, max: usize) -> &str { if s.len() <= max { s } else { &s[..max] } }