游戏叙事与剧情 / 系统课时

变量名如何避免歧义

变量名如何避免歧义

剧情变量一旦进入脚本、存档和分析系统,就会被策划与程序长期共同使用。模糊命名会让“次数、状态、范围、单位”在后期变得难以判断。本节建立一套轻量命名约束,让变量从名字和默认值就能看出真实含义。

学习目标

  • 用名称表达对象、含义和数据类型倾向
  • 区分全局、章节、角色等不同作用域
  • 为默认值、单位和枚举范围建立一致约束

名字先表达业务语义

变量名应先回答“谁的什么状态”,再考虑缩写是否省字符。value1、flagA、count 在创建当天可能看得懂,几周后就很难判断它们属于谁、统计什么。

更稳妥的名字会把对象和含义一起写出来,例如 guardTrustLevel、heroRescueCount、seenEndingIds。其中 Level 暗示等级,Count 暗示次数,复数 Ids 暗示多个唯一标识。

命名不必无限变长,但应避免依赖注释才能理解核心含义。若删除注释后变量仍能被正确使用,命名通常才算合格。

作用域必须能被看见

剧情状态经常同时存在全局、章节、场景和角色范围。如果不同范围都使用 isUnlocked,读代码时就很容易把一个局部条件误当成全局结果。

可以采用统一前缀或结构化对象表达作用域,但一套项目只选一种方式。例如对象式组织更适合变量较多的项目:

json
{
  "global": {
    "endingRoute": "none"
  },
  "chapter02": {
    "gateOpened": false
  },
  "characters": {
    "guard": {
      "trustLevel": 0
    }
  }
}

这份结构的生效行为是:读取路径本身就能说明变量归属。验证时可以随机抽取几个条件,确认策划仅凭路径就能判断它是全局状态、章节状态还是角色状态。

默认值也是规则的一部分

变量名清楚,但默认值不明确,同样会制造歧义。布尔值要明确初始是 false 还是“未知”;计数器通常从 0 开始;枚举变量要给出合法初始值,而不是依赖空字符串。

如果“尚未选择”和“选择了 none”在业务上不同,就不要让它们共用一个值。此时可以定义明确枚举,例如 unselected、peace、revenge,让状态机不会把缺失值误判成某个正常分支。

单位要写进命名或约束

涉及时间、距离、概率和资源值时,最容易出现“数值正确、单位理解错误”。例如 cooldown = 30 无法看出是秒、毫秒还是回合数。

如果单位固定且不会改变,可以直接写入名称,例如 choiceTimeoutSeconds、fadeDurationMs。若单位属于领域模型的一部分,也可以把值和单位一起结构化保存。

json
{
  "choiceTimeoutSeconds": 15,
  "relationshipScore": 20,
  "relationshipScoreRange": {
    "min": -100,
    "max": 100
  }
}

验证方法很直接:让未参与该变量创建的人只看名称与约束,判断数值含义、合法范围和作用域。如果仍需口头补充关键信息,变量定义还不够自解释。

用一份小规范持续约束

团队最终需要的不是复杂命名法,而是一份所有人都能执行的短规则:布尔量优先使用 is、has、can 等语义前缀;次数使用 Count;唯一标识集合使用复数 Ids;时间和距离写明单位;作用域通过路径或前缀固定表达。

命名规则的价值在于降低后续判断成本。变量越容易从名称、作用域、默认值和单位直接读懂,剧情分支越不容易因为“大家以为它表示另一件事”而失效。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

变量名如何避免歧义

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通