TreeMap 是一款可在 macOS、Windows 与 Linux 上运行的免费磁盘空间可视化工具——它把整块硬盘画成方块图与图表，还能帮你删掉占空间的文件。正因为"删除文件"是写操作，TreeMap 的测试体系格外硬核：439 个测试文件、7500+ 用例、变异测试（Mutation Testing）与黄金字节级一致性（Golden Byte-Identical）校验，层层设防。🧪

7500+ 用例全景：三层测试矩阵

用例覆盖从扫描引擎、API 契约、路径安全（tests/pathGuardBoundary.test.ts）、回收站行为，到 UI 文案与视觉动效（tests/polishVisualMotion.test.ts），几乎每个模块都有"诚实性"用例——比如 tests/duplicatesHonesty.test.ts 专门验证重复文件报告绝不虚报。

变异测试：证明每条断言"真的会咬人"

TreeMap 的开发铁律是red-first（先红后绿）：新增的每一条断言，都必须先被一个"变异体"（故意注入的缺陷）打红，才允许合入——记录见 HANDOFF.md。

• Rust 侧：用cargo-mutants对 tm-store、tm-walk 等 crate 逐轮变异，单轮如 "43/43 mutants red"、"44/44 mutants"，一个存活（survivor）都不放过；
• TS 侧：tests/frontendContract.test.ts 内置了"自我变异"演示——测试直接从源码里删掉一行关键防护代码，然后证明：旧断言竟然还绿（暴露缺陷），新断言立即变红（缺陷被捕获）。

换句话说，"测试通过"在这里只是及格线，"测试能抓到删掉的代码"才是满分。🧬

黄金字节级一致性：API 响应逐字节对比

当存储引擎从"对象树"重写为结构体数组（SoA，每文件仅约 52 字节）后，如何证明前端看到的 JSON 一丝不差？答案在 tests/goldenResponses.test.ts：

1. 用重写前基线（v2.3.2，commit 16ae5b8）录制一份黄金响应 responses.json；
2. 在当前服务器上重放同一个固定夹具（fixture）扫描；
3. 对每个端点的序列化字节逐字节断言——字段名、大小、mtime、子节点顺序、属性顺序全部一致；
4. 仅对真正易变的值（scanId、时间戳等）在两侧做同样的归一化。

Rust 原生扫描引擎同样受"等价测试"约束：它产出的 JSON 必须与内置 walker逐字节相同，让性能提升永远不改变语义。🔒

连 UI 的几何算法也有专属用例，如 tests/voronoiTreemap.test.ts 与 tests/mapPaintFidelity.test.ts——画在屏上的每一块颜色都被断言过。

差分模糊测试：双引擎互相当"裁判"

tests/fixtures/storeFuzz.ts 用确定性随机数生成器随机造出包含中文文件名、硬链接、容器包、云占位符的巨型目录树，再把同一串操作同时喂给内存对象存储与压缩 SoA 存储，以 tests/packedStore.test.ts 中的 oracle 逐值对账。随机即确定性：种子固定，任何一次回归都能在本地精确复现。

如何运行 TreeMap 测试套件

# 完整 Node 测试（跨 shell 运行器） npm test # 只跑单个测试文件 npx tsx --test tests/goldenResponses.test.ts # Rust 原生引擎全量测试 npm run test:native

配置见 package.json，运行器为 scripts/run-tests.js。CI 会跑满四条腿（macOS / Windows / Linux / Linux pt-BR）全绿才放行。安全护栏同样可靠：所有测试通过isolatedDataDir隔离数据目录，绝不误触真实应用数据；测试看门狗（scripts/testFileWatchdog.cjs）会杀掉超时或内存失控的进程。

小结

TreeMap 的测试哲学可以浓缩成三句话：用例多到穷尽（439 文件、7500+ 用例）、断言必须会咬人（变异测试 red-first）、重构必须无感（黄金字节级一致性 + 差分模糊）。这也解释了为什么敢把"删除文件"写进一款可视化工具的功能列表里。✅