创游世界存档与云变量设计入门
一句话摘要
本文帮助你区分临时数据、对象状态、地图共享数据和长期数据，判断哪些值适合存档，哪些值不该乱塞进云变量，建立正确的数据持久化意识。
适合谁阅读
- 需要设计存档系统的创作者
- 遇到数据分层混乱的开发者
- 想区分联机同步与持久化的进阶用户
你将学到什么
- 四种数据层的区分方法
- 什么值适合做存档
- 云变量适合做什么不适合做什么
- 存档设计的关键边界问题
- 联机同步与持久化的区别
- 常见误区与避坑建议
1. 这篇文档的定位
很多人一提“存档”，就会下意识把所有值都往持久化方向想；一提“云变量”，又容易把它当作万能数据仓库。
其实更重要的问题是：
哪些值真的需要被保存，哪些值只应该存在于当前运行过程。
2. 先分清几种数据层
2.1 临时运行数据
只在当前过程里有意义。
例如：
- 当前攻击前摇计时
- 临时目标引用
- 一次计算中的中间值
这类通常不该存档。
2.2 对象状态数据
属于某个对象自身状态。
例如：
- 当前血量
- 当前冷却
- 是否已激活
这类是否持久化，要看项目需求。
2.3 地图共享数据
属于本局地图过程。
例如：
- 当前波次
- 地图公共进度
- 当前挑战完成度
这类常常是“本局有意义”，不一定要长期保存。
2.4 全局长期数据
适合做存档或长期保留。
例如：
- 总金币
- 已解锁角色
- 已完成章节
- 永久升级等级
3. 什么值适合做存档
通常更适合持久化的是：
- 玩家长期进度
- 解锁状态
- 永久货币
- 永久道具拥有情况
- 成就/图鉴/收集进度
因为这些值跨地图、跨局次、跨时间仍然有意义。
4. 什么值不适合随便存档
通常不建议乱存的有：
- 临时攻击状态
- 某一帧的动作状态
- 当前按钮是否高亮
- 临时 UI 显示内容
- 一次性计算缓存
原因很简单： 这些值大多只是运行时过程状态，不具备长期保存价值。
5. 云变量适合做什么
云变量更适合：
- 长期保存关键数据
- 在需要同步/外部保存时使用
- 作为重要进度的持久化层
但它不适合：
- 替代所有局部变量
- 替代所有地图属性
- 把每个瞬时状态都同步出去
一句话：
云变量适合存“结果”，不适合存“每一个过程细节”。
6. 存档设计时最重要的是边界
建议先问自己 3 个问题：
- 这个值跨地图后还重要吗？
- 这个值下次打开游戏还需要吗？
- 如果不保存它，玩家体验会不会明显断裂？
如果三个问题都偏“否”，那它大概率不该进入长期存档层。
7. 存档与 UI 的关系
一个非常常见的错误是：
- 先做 UI
- 再把 UI 上显示的东西当存档内容
更稳的做法是：
- 先定义真实要保存的数据结构
- 再让 UI 去读取这份结构并显示
也就是说：
存档读写是数据层问题，不是 UI 层问题。
8. 联机与持久化不要混成一件事
联机同步关注的是：
- 当前多人过程里数据是否一致
- 现在这一刻大家看到的状态是否同步
持久化关注的是：
- 退出后还能不能保留
- 下次进入还能不能恢复
它们相关，但不是同一件事。
9. 一个简单的设计思路
以“永久金币 + 本局金币”为例：
- 永久金币：适合存档 / 云变量
- 本局金币：适合地图过程数据
- UI 当前显示金币：只是显示层
如果把这三层混成一层，后面会很容易出错。
10. 新手常见误区
10.1 什么都想存
结果导致结构臃肿，还容易出同步问题。
10.2 把 UI 值直接当存档真值
这会让后期维护非常难。
10.3 不区分“长期拥有”和“本局获得”
像货币、道具、任务进度这类系统经常因此混乱。
10.4 联机同步和持久化混为一谈
结果既不稳，也不好调试。
11. 一句总结
先决定什么值得长期保存，再决定用什么方式保存；不要因为能存，就把所有值都塞进存档。
12. 当前文档边界与待补点
- 当前内容以“数据分层原则”和“项目设计边界”为主，属于结构化入门研究。
- 直接来自官方界面/更新说明的云变量细节证据仍然偏少，后续应继续补版本页和截图编号。
- 后续最值得补的是：
- 云变量与玩家变量、地图属性、系统属性的更细对照
- 持久化和联机同步的边界案例
- 老版本到新版本在数据上限、命名、兼容策略上的演进
待验证问题
以下问题需要进一步验证：
| 问题 | 状态 | 验证方向 |
|---|---|---|
| 云变量与玩家变量、地图属性、系统属性的更细对照 | 🔄 待验证 | 需要官方文档确认 |
| 持久化和联机同步的边界案例 | 🔄 待验证 | 需要实际项目测试 |
| 老版本到新版本在数据上限、命名、兼容策略上的演进 | 🔄 待验证 | 需要多版本对比 |
📝 说明：存档核心原则已稳定，云变量细节需要官方文档进一步确认。
关联阅读
docs/脚本系统/专题研究/脚本作用域与数据流深度研究.mddocs/脚本系统/专题研究/创游世界UI数据同步架构.mddocs/脚本系统/专题研究/创游世界项目结构模板.mddocs/脚本系统/专题研究/创游世界任务与事件系统设计入门.mddocs/脚本系统/专题研究/创游世界交互系统设计入门.mddocs/引擎更新/专题研究/联机UI演进专题.mddocs/引擎更新/引擎更新知识索引.mddocs/元信息/创游世界术语表.mddocs/社区分析/待验证问题清单.md