游戏叙事与剧情 / 系统课时
变量名如何避免歧义
变量名如何避免歧义
剧情变量一旦进入脚本、存档和分析系统,就会被策划与程序长期共同使用。模糊命名会让“次数、状态、范围、单位”在后期变得难以判断。本节建立一套轻量命名约束,让变量从名字和默认值就能看出真实含义。
学习目标
- 用名称表达对象、含义和数据类型倾向
- 区分全局、章节、角色等不同作用域
- 为默认值、单位和枚举范围建立一致约束
名字先表达业务语义
变量名应先回答“谁的什么状态”,再考虑缩写是否省字符。value1、flagA、count 在创建当天可能看得懂,几周后就很难判断它们属于谁、统计什么。
更稳妥的名字会把对象和含义一起写出来,例如 guardTrustLevel、heroRescueCount、seenEndingIds。其中 Level 暗示等级,Count 暗示次数,复数 Ids 暗示多个唯一标识。
命名不必无限变长,但应避免依赖注释才能理解核心含义。若删除注释后变量仍能被正确使用,命名通常才算合格。
作用域必须能被看见
剧情状态经常同时存在全局、章节、场景和角色范围。如果不同范围都使用 isUnlocked,读代码时就很容易把一个局部条件误当成全局结果。
可以采用统一前缀或结构化对象表达作用域,但一套项目只选一种方式。例如对象式组织更适合变量较多的项目:
{
"global": {
"endingRoute": "none"
},
"chapter02": {
"gateOpened": false
},
"characters": {
"guard": {
"trustLevel": 0
}
}
}这份结构的生效行为是:读取路径本身就能说明变量归属。验证时可以随机抽取几个条件,确认策划仅凭路径就能判断它是全局状态、章节状态还是角色状态。
默认值也是规则的一部分
变量名清楚,但默认值不明确,同样会制造歧义。布尔值要明确初始是 false 还是“未知”;计数器通常从 0 开始;枚举变量要给出合法初始值,而不是依赖空字符串。
如果“尚未选择”和“选择了 none”在业务上不同,就不要让它们共用一个值。此时可以定义明确枚举,例如 unselected、peace、revenge,让状态机不会把缺失值误判成某个正常分支。
单位要写进命名或约束
涉及时间、距离、概率和资源值时,最容易出现“数值正确、单位理解错误”。例如 cooldown = 30 无法看出是秒、毫秒还是回合数。
如果单位固定且不会改变,可以直接写入名称,例如 choiceTimeoutSeconds、fadeDurationMs。若单位属于领域模型的一部分,也可以把值和单位一起结构化保存。
{
"choiceTimeoutSeconds": 15,
"relationshipScore": 20,
"relationshipScoreRange": {
"min": -100,
"max": 100
}
}验证方法很直接:让未参与该变量创建的人只看名称与约束,判断数值含义、合法范围和作用域。如果仍需口头补充关键信息,变量定义还不够自解释。
用一份小规范持续约束
团队最终需要的不是复杂命名法,而是一份所有人都能执行的短规则:布尔量优先使用 is、has、can 等语义前缀;次数使用 Count;唯一标识集合使用复数 Ids;时间和距离写明单位;作用域通过路径或前缀固定表达。
命名规则的价值在于降低后续判断成本。变量越容易从名称、作用域、默认值和单位直接读懂,剧情分支越不容易因为“大家以为它表示另一件事”而失效。