游戏客户端架构 / 系统课时

数值、文本和布尔类型怎么选

数值、文本和布尔类型怎么选

配置表里的字段类型不是“能存进去就行”,而是在决定导入时怎么校验、序列化后如何表达,以及运行时要不要再次转换。本节用伤害、名称和开关三个典型字段建立一套选择规则,让错误尽量在导入阶段暴露,而不是进入游戏后才发现。

学习目标

  • 根据业务含义选择整数、浮点数、文本和布尔类型
  • 理解类型选择对导入校验、序列化和运行时访问的影响
  • 能为边界值、空值和非法字面量设计明确的校验规则

字段类型先表达业务含义

判断字段类型时,先问“这个值允许做什么”,再问“表格软件里看起来像什么”。伤害次数、等级、堆叠上限通常是整数;移动速度、暴击倍率这类允许小数的量适合浮点数;名称、资源键、描述属于文本;是否可交易、是否默认启用则应使用布尔类型。

业务字段 推荐类型 不推荐做法 主要原因
level 整数 文本 "10" 会把数值校验推迟到运行时
moveSpeed 浮点数 整数缩放值 除非项目明确采用定点数约定
displayName 文本 枚举 文案通常需要频繁调整或本地化
tradable 布尔 0/1、Y/N 混用 字面量不统一容易产生歧义

文本并不等于“万能类型”。把所有字段都导成字符串虽然省事,但每个使用方都要重新解析,错误也会从一次导入检查扩散到多个运行时分支。

导入阶段要严格拒绝模糊值

配置导入器应把原始单元格转换成明确类型,并在转换失败时直接报错。特别是布尔值,不要依赖“非空就算真”或把未知字符串悄悄当成 false。

下面的 Java 17 示例模拟一行配置的导入过程,对正整数和布尔值做严格校验:

java
import java.util.Map;

public class ConfigTypeDemo {
    record ItemConfig(int maxStack, String displayName, boolean tradable) {}

    public static void main(String[] args) {
        Map<String, String> row = Map.of(
                "maxStack", "99",
                "displayName", "治疗药水",
                "tradable", "true"
        );

        ItemConfig config = new ItemConfig(
                parsePositiveInt(row.get("maxStack"), "maxStack"),
                requireText(row.get("displayName"), "displayName"),
                parseStrictBoolean(row.get("tradable"), "tradable")
        );

        System.out.println(config);
    }

    static int parsePositiveInt(String raw, String field) {
        int value = Integer.parseInt(raw);
        if (value <= 0) {
            throw new IllegalArgumentException(field + " must be > 0");
        }
        return value;
    }

    static String requireText(String raw, String field) {
        if (raw == null || raw.isBlank()) {
            throw new IllegalArgumentException(field + " must not be blank");
        }
        return raw;
    }

    static boolean parseStrictBoolean(String raw, String field) {
        if ("true".equalsIgnoreCase(raw)) return true;
        if ("false".equalsIgnoreCase(raw)) return false;
        throw new IllegalArgumentException(field + " must be true or false");
    }
}

预期输出:

text
ItemConfig[maxStack=99, displayName=治疗药水, tradable=true]

实际项目中,Integer.parseInt 的格式异常也应被导入框架捕获,并补充表名、行号和字段名,这样策划能直接定位原始数据。

序列化后不要丢失类型信息

配置转成 JSON、二进制或引擎资产后,应继续保留原始类型。整数仍是数字,布尔值仍是 true 或 false,不要为了“格式统一”再次变回字符串。这样运行时读取后可以直接参与计算和条件判断,不需要二次解析。

如果某个字段允许“未填写”,要显式定义它的语义。比如冷却时间为空究竟表示 0 秒、继承默认值,还是配置错误,三者不能靠调用方猜测。稳定的做法是在导入规则里把空值转换成明确默认值,或者直接拒绝缺失。

运行时类型要兼顾范围与精度

整数还要考虑范围,浮点数还要考虑精度。数量、ID、自增计数等只要可能超过 32 位上限,就应在数据模型里使用更大的整数类型;货币、固定倍率等如果要求精确十进制,不应直接依赖二进制浮点数做最终结算。

当字段含义清晰时,优先使用最具体的类型:能用布尔就不要用文本开关,能用数字就不要存数字字符串;只有真正属于标识、文案或自由输入的内容才使用文本。

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

目录与阅读设置

阅读设置

17

记录一个想法

数值、文本和布尔类型怎么选

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

登录哪都通