创游世界变量完全指南
一句话摘要
本文详细介绍创游世界中的变量系统，解释什么是变量、不同类型的变量、如何选择合适的作用域，以及变量的使用场景和最佳实践。
适合谁阅读
- 完全不知道"变量"是什么的初学者
- 知道变量但不知道怎么选的开发者
- 想深入理解变量作用域的进阶用户
你将学到什么
- 变量的定义和作用
- 变量的类型（数字、文本、真假值等）
- 变量的作用域层级
- 如何根据场景选择合适的作用域
- 变量的使用场景和最佳实践
1. 什么是变量？
变量是存储数据的容器，就像一个带标签的盒子，可以往里面放东西，也可以取出来。
变量的使用场景
| 功能 | 示例 |
|---|---|
| 记住玩家选择 | 记住玩家选了哪个角色 |
| 记录游戏状态 | 记录当前关卡、血量、分数 |
| 存储临时计算 | 计算伤害、距离、概率 |
| 控制逻辑流程 | 判断是否满足某个条件 |
2. 变量的数据类型
基础数据类型
| 类型 | 说明 | 示例 |
|---|---|---|
| 数字 | 整数或小数 | 100、3.14、-50 |
| 文本 | 字符串，一段文字 | "Hello"、"金币+100" |
| 真假值 | 只有两个值：对/错 | true / false |
| 颜色 | 红绿蓝或HSB值 | #FF0000、RGB(255,0,0) |
| 向量 | 二维坐标点 | (100, 200) |
相关阅读：创游世界数据类型速查卡
3. 变量的作用域层级
创游世界中的变量有四个作用域层级：
| 层级 | 名称 | 生命周期 | 谁能用 |
|---|---|---|---|
| 1 | 局部变量 | 脚本执行期间 | 只有当前脚本 |
| 2 | 自身属性 | 对象存在期间 | 当前物体 |
| 3 | 地图属性 | 地图存在期间 | 同地图所有物体 |
| 4 | 系统属性 | 整个游戏 | 所有场景 |
层级选择原则
选哪个作用域？
├─ 只在当前脚本用一次？
│ └─ → 局部变量
│
├─ 只属于这个物体？
│ └─ → 自身属性
│
├─ 同地图多个物体会用到？
│ └─ → 地图属性
│
└─ 全游戏都要用？
└─ → 系统属性相关阅读：创游世界变量作用域速查卡
相关阅读：创游世界变量与作用域完全指南
4. 变量的使用场景
场景1：记分系统
[得分物体]
当 与玩家碰撞时
└─ 设置系统.得分 = 系统.得分 + 10
└─ 销毁自身
└─ 发送广播 "刷新得分UI"场景2：血量管理
[玩家角色]
当 受到伤害时
└─ 设置自身.血量 = 自身.血量 - 事件.伤害值
└─ 如果 自身.血量 <= 0 则
└─ 发送广播 "游戏失败"
└─ 销毁自身5. 常见问题与解决
Q1：变量值丢失怎么办？
检查清单：
- 变量作用域是否正确？
- 物体销毁后自身属性会重置
- 切换地图后地图属性会重置
- 系统属性不会丢失
Q2：应该用哪个作用域？
决策树：
需要跨地图持久化？
├─ 是 → 系统属性
└─ 否 →
需要同地图共享？
├─ 是 → 地图属性
└─ 否 →
需要跨脚本保留？
├─ 是 → 自身属性
└─ 否 → 局部变量相关阅读：创游世界新手常见问题汇总
6. 最佳实践总结
应该做
| 实践 | 说明 |
|---|---|
| 明确变量作用域 | 根据数据用途选择正确的作用域 |
| 使用清晰的命名 | 系统.金币 比 变量1 更清晰 |
| 先初始化再使用 | 确保变量有默认值 |
| 善用局部变量 | 临时计算用局部变量 |
不应该做
| 实践 | 问题 |
|---|---|
| 用变量存UI状态 | UI状态应该用广播更新 |
| 所有数据都用系统属性 | 降低性能，增加同步负担 |
| 变量命名不规范 | 后期难以维护 |
相关页面
入门文档
核心研究
速查卡片
导航入口
待验证内容
以下内容需要进一步验证：
| 内容 | 状态 | 说明 |
|---|---|---|
| 结构体的具体使用方式 | 待验证 | 需要截图确认 |
| 数组的创建和操作方法 | 待验证 | 需要实际测试 |
最后更新：2026-06-10维护者：Azek431