Revolution 导表工具 对比与设计说明

1零依赖：不再被第三方库绑架

早期版本：框架被迫链上 Newtonsoft.Json（JsonDataMgr 与导表工具都用 JsonConvert），Excel 解析还要一个 Excel.dll。

新版：零第三方依赖。xlsx 本质是 zip + XML，用 ZipArchive + XDocument 就够；数据格式自己定，不需要 JSON 库。

收益：升级 Unity / 换 .NET 版本时不用等第三方库跟进，也不必为了"读个表"把整个 JSON 库拖进包里。

2零 GC：struct + 生成的强类型解析

早期版本每一行每个字段都走反射：

// 反射填数据
FieldInfo f = t.GetField(name);
f.SetValue(instance, ConvertValue(cell, f.FieldType));  // 每格一次装箱

SetValue(object) 对 int/float/bool 都要装箱。5 万行 × 10 个数值列 = 50 万次装箱，全变成 GC 垃圾。

新版是生成出来的直接赋值：

data.Id     = RevDataFieldParser.ToInt(cells[0]);
data.Attack = RevDataFieldParser.ToFloat(cells[3]);

收益：加载期几乎不产生 GC；值类型连续存放，缓存友好。

3生命周期正确：表是一种"资源"

早期版本只有 LoadTable<T,K>() 与 GetTable<T>()，没有卸载，tableDic 只增不减；且从 StreamingAssets 直接读（Android 要 UnityWebRequest、iOS 要拼 file://），绕过资源系统 = 没有缓存、没有引用计数。

新版统一走资源系统，白拿四件事：

await RevDataTableManager.LoadAsync<HeroTable>();
// ① 缓存   ② 引用计数
// ③ 分组卸载  ④ 平台透明

并且禁止直接拼 StreamingAssets 路径 —— 那等于绕开上面四条。

4数据可读、可 diff

早期版本 .tang 二进制：策划改一个数值，git diff 只会说"文件已更改"，看不出改了哪一行。

新版 TXT 带表头注释：

#Hero
#ID  Name  Quality  Attack ...
#英雄ID 英雄名 品质(1-5) 攻击力 ...
1001  亚瑟  3  120.5  3600  3.8  false  秩序  持剑的圣骑士

收益：diff 直接显示"亚瑟攻击力从 120 改成 120.5"；评审、查数值改动成本从"开工具比对"降到"看一眼"。

5错误前置：导表是集中暴露问题的唯一机会

早期版本边解析边生成，主键重复甚至要拖到运行时由 DuplicateKeyBehavior 决定。

新版导出前全量校验，并分级处理：

[错误] 第 5 行 [Cost]："abc" 不是合法的 int
[错误] 第 6 行：主键 [Id] = 101 重复
[错误] 字段名 [英雄 id] 不能作为 C# 标识符
[提示] 表 [Item] 校验未通过，已跳过导出（2 个错误）

行号与 Excel 左上角一致；坏表跳过、好表照导。

6契约唯一：写端和读端是同一份源码

最容易踩、最难查的一类 bug：工具写出来的格式，运行时读不懂。

早期版本写端在 ExcelTool.cs、读端在 BinaryDataMgr.cs，格式各写一遍，一方改了另一方没同步就要到真机才暴露。

新版格式规则只存在于 RevDataTextFormat.cs，工具工程直接链接它：

<Compile Include="..\...\RevDataLoad\Core\RevDataTextFormat.cs"
         Link="Shared\RevDataTextFormat.cs" />

收益：改一处两端同时生效，"写读不一致"在结构上不可能发生。

7主键类型不限，表名可字符串驱动

早期版本两条路径的主键约定互相打架：JSON 路径硬性要求主键字段名必须是 id 且类型为 string（直接 GetField("id")），想用 int 主键就只能走二进制那条路。

新版主键类型完全由 Excel 第 2 行决定，int / string 都支持：

ID:int     →  RevDataTable<int, Hero>       FindByKey(1001)
ID:string  →  RevDataTable<string, Buff>    FindByKey("BUFF_ATK_UP")

运行时还能按字符串表名取表，"表名来自配置"的场景也能写：

RevIDataTable t = RevDataTableManager.Get("Buff");
RevDataTableManager.TryGet<BuffTable>("Buff", out var buff);
// 内部两张索引指向同一实例：
//   表名 → 容器（字符串查询） / 容器类型 → 容器（泛型，O(1)）

工具侧还加了主键类型体检：用 float 或 bool 做主键会提示（浮点精度会导致"表里明明有却查不到"；bool 最多两行数据，基本是配错了）。