AssetRipper 数据存储与查询配置管理完整指南

AssetRipper 数据存储与查询配置管理完整指南

【免费下载链接】AssetRipperGUI application to analyze game files项目地址: https://gitcode.com/GitHub_Trending/as/AssetRipper

AssetRipper 是一个用于 Unity 资产提取的工具：你导入游戏文件，它帮你还原出纹理、模型、脚本等资产。而每次操作中“导入什么、怎么导出”的偏好，以及追踪每个资产时记录的元信息，都依赖一套统一的 AssetRipper 配置管理机制来落盘和检索。这篇文章从使用者的角度讲清楚：数据存在哪里、对象如何变成可保存的文本、又该如何读取和查询。

为什么需要一套专门的存储层

⚙️ 处理游戏文件时，工具需要记住三类东西：

• 你本次的偏好：导入开关、导出范围、处理选项；
• 遍历资产时顺带发现的元信息：名称、路径、依赖关系；
• 每类数据的默认值。

如果这些值散落在各个功能模块里，那么“恢复上次的设置”“整体清空”“只改其中一项”就要去改很多地方。所以 AssetRipper 把所有键值数据收进同一套字典式容器，再按值的形态分类：

• 单份配置 → 单例存储；
• 同类型的一批值 → 列表存储；
• 值本身 → 统一交给序列化器做“对象 ⇄ 文本”转换。

好处是读写、清空、落盘都有唯一入口，新增一个设置时只需要选对容器。

三类数据分别放在哪里

存储与查询的核心实现都在 Source/AssetRipper.Configuration/ 模块内，所有条目都以字符串为键。

单份配置：一个键对一个值

SingletonDataStorage保存“一个键对应一个对象”的设置，适合单个导入配置、单个开关、单个版本号。读取时提供两种姿态：

• TryGetStoredValue：键不存在或类型不符时返回 false，不抛异常，适合“先查再用”；
• GetStoredValue：键不存在时直接抛KeyNotFoundException，适合“必须有”的强制字段。

列表数据：一个键对应一批同类型值

ListDataStorage在单个键下保存一批同类型数据，比如资产路径清单、勾选的文件名列表。写入时直接把完整的List<string>或List<T>交给它，它会自动打包成对应的列表数据集。

三种形态对比

数据形态	容器	典型值	读取方式
单份配置	SingletonDataStorage	字符串 / 可解析类型 / JSON 对象	TryGetStoredValue/GetStoredValue
列表	ListDataStorage	字符串列表 / 对象列表	GetValue/ 按下标访问
通用条目	DataStorage<T>基类	任意DataEntry	索引器 /TryGetValue

注意：所有读取都会做类型校验——键存在但存的类型与你要的不一致时，一律按“没找到”处理。这是故意的，防止悄悄取出错误数据。

数据如何变成文本，又如何变回对象

🔎 容器里装的是“对象”，但真正落盘的是文本。桥梁是序列化器：读取时把对象转成文本，给文本赋值时再解析回对象。内置三种方式：

序列化方式	适合的数据	解析失败时
字符串	纯文本	不会失败
可解析类型（IParsable<T>）	能从字符串还原的类型	返回默认新实例
JSON（System.Text.Json）	复杂对象	返回默认新实例

两点值得留意：

• 宽容解析：后两种序列化器遇到空文本或损坏文本时，返回一个空的新对象，而不是抛异常——单条数据损坏不会卡死整个流程；
• 副作用是“配置损坏看起来像被重置过”。怀疑配置被覆盖时，先检查落盘的原始文本，而不是反复重读对象。

三个最常用的查询操作

如何读取一份配置

if (storage.TryGetStoredValue("exportSettings", out var settings)) { // 使用 settings }

“exportSettings”只是示例键名，真实键以项目当前实现为准。

列表数据怎样批量遍历

两种方式按场景选：

• 只要字符串形式：走Strings视图，每个元素在访问时才转成字符串；
• 需要原始类型：直接把DataSet<T>当作只读列表遍历，省去逐项序列化的开销。

只展示一遍用前者即可；几千条循环处理时，建议用带类型的形式。

如何快速定位某个资产

对列表做“是否存在 / 下标是多少”这类反复判断时，先在内存里建一张“值 → 下标”的映射，之后全部走字典查找，避免每次从头线性扫描整个列表：

首次遍历建“值→下标”映射 后续命中一次字典查找即可

查询时的性能注意点

• 按键取值的本身是字典操作，主要开销发生在伴随的序列化 / 反序列化上；
• 写入列表：一次性给完整列表。实现里对已知数量的批次会预先分配容量，逐条追加效率更低；
• 用Strings字符串视图遍历时，每个元素都实时转字符串，批量场景优先用带类型的列表；
• Clear()是把所有条目重置为默认值，语义是“整体复位”，不是“删除某一项”；
• 源码中未见显式加锁，不要假设多线程可并行读写，以项目当前实现为准。

排查清单与下一步

✅ 配置“读不出来”时按顺序检查：

1. 键名是否存在，拼写和大小写是否一致；
2. 类型参数是否对——TryGetStoredValue<T>的T必须和当初存入的类型一致；
3. 文本是否损坏——宽容解析会返回空对象，表现是“值变默认”，而不是报错。

下一步你可以：

• 打开 Source/AssetRipper.Configuration/，存储容器与序列化器都在这里，代码量不大，适合通读一遍；
• 习惯上先用 Try 系方法确认键和类型，再决定用 Get 系方法提交读取；
• 新增一个设置时，先判断它是“单份”还是“列表”，再决定用字符串、可解析还是 JSON 序列化器。

【免费下载链接】AssetRipperGUI application to analyze game files项目地址: https://gitcode.com/GitHub_Trending/as/AssetRipper