数据、变量与作用域导航

一句话摘要

这是一份聚合数据与变量作用域核心文档的中文导航，帮助你快速找到数据归属、真值分层、持久化、云变量等高价值专题。

适合谁阅读

• 不知道变量应该放哪一层的创作者
• 遇到数据丢失、状态错乱的开发者
• 想做存档、背包、商店系统的进阶用户

你将学到什么

• 数据与变量核心文档入口
• 四层作用域速查
• 按问题找文档的方法
• 常见误区与避坑建议

推荐先读

1. 脚本作用域与数据流深度研究 - 变量作用域详解
2. 创游世界存档与云变量设计入门 - 持久化设计
3. 创游世界UI数据同步架构 - 数据分层

数据与变量核心文档

基础理解

文档	说明	适合阶段
脚本作用域与数据流深度研究	局部/自身/地图/系统四层作用域	入门/进阶
创游世界数据类型完全指南	数据类型与转换	进阶
核心概念速查手册	变量概念速查	入门

持久化与存档

文档	说明	适合阶段
创游世界存档与云变量设计入门	存档设计与云变量	进阶
4.54.0数据类型与脚本能力升级解析	新版本数据类型能力	进阶

数据分层与架构

文档	说明	适合阶段
创游世界UI数据同步架构	UI与真值分层	进阶
创游世界数据分层模型	数据分层模型	进阶
创游世界项目结构模板	项目结构与数据放置	进阶

列表与背包

文档	说明	适合阶段
创游世界格子UI与列表系统深度解析	列表真值管理	进阶
创游世界背包与货币系统设计入门	背包数据设计	进阶

按问题找文档

1. 我不知道一个值该放UI、地图还是系统层

• 脚本作用域与数据流深度研究
• 创游世界项目结构模板

2. 我想做长期保存、跨地图保留、云端同步

• 创游世界存档与云变量设计入门
• 4.54.0数据类型与脚本能力升级解析

3. 我想做背包、商店、列表、详情面板共用一份真值

• 创游世界背包与货币系统设计入门
• 创游世界格子UI与列表系统深度解析
• 创游世界UI数据同步架构

4. 我想理解战斗、任务、交互里的状态应该怎么分层

• 创游世界战斗系统设计入门
• 创游世界任务与事件系统设计入门
• 创游世界交互系统设计入门

四层作用域速查

层级	名称	生命周期	存储位置	用途
1	局部变量	脚本执行期间	脚本内部	临时计算
2	自身属性	对象存在期间	组件属性	对象自身状态
3	地图属性	地图存在期间	地图对象	同地图共享
4	系统属性	整个游戏	系统层	全局数据

核心概念速查

概念	解释
真值层	存放项目核心数据的层（地图层或系统层）
显示层	UI负责显示和接收输入
广播解耦	UI发请求广播，地图处理后通知UI刷新
玩家变量	跨会话持久化的数据
云变量	存储在云端、可跨设备同步的变量
存档	持久化保存玩家数据的技术

当前判断

• [已确认] 数据放错层，是很多项目越做越乱的根源之一。
• [已确认] "UI负责显示，玩法层负责真值"是当前知识库里反复被验证的高频稳定原则。
• [高可信推断] 后续若继续补联机同步、多人数据一致性与回档恢复专题，这个栏目会更重要。

常见误区

误区	后果	正确做法
把UI状态当成真值	切地图后状态丢失	真值放在地图层或系统层
所有数据都放在局部变量	脚本执行完就消失	持久数据放自身/地图/系统属性
把配置数据写在玩家变量表	存档包含大量静态数据	静态配置写在配置表
不做数据初始化	老存档缺少新字段	在"玩家开始时"做数据同步补丁

关联阅读

核心研究

• 核心概念速查手册 - 核心概念速查
• 核心研究导航 - 核心研究总入口
• UI与交互研究导航 - UI系统研究入口
• 脚本系统研究导航 - 脚本系统研究入口
• 版本与能力边界导航 - 版本差异导航

脚本系统

• 脚本系统导航 - 脚本系统总入口
• 自定义组件深度解析 - 自定义组件详解
• 脚本作用域与数据流深度研究 - 数据流研究

项目设计

• 项目设计导航 - 项目设计总入口
• 系统设计专题导航 - 系统设计专题
• 创游世界项目结构模板 - 项目结构模板

教程资料

• 教程资料导航 - 教程资料总入口
• 常见问题与避坑指南 - 问题解决
• 创游世界新手常见卡点与避坑清单 - 避坑清单

导航入口

• 新手阅读路线 - 学习路线导航
• 创游世界知识库总导航 - 知识库总导航

---

待验证问题

以下问题需要进一步验证：

问题	状态	验证方向
联机同步机制的详细参数	🔄 待验证	需要联机环境测试
不同版本引擎的数据同步策略差异	🔄 待验证	需要多版本对比测试

📝 说明：单机游戏的数据存储已稳定，联机相关内容属于进阶研究。

后续优化方向

• [ ] 补充联机同步与多人数据一致性专题
• [ ] 添加回档恢复的详细文档
• [ ] 完善云变量与玩家变量的对比说明