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

时间、枚举和浮点数怎么落盘

时间、枚举和浮点数怎么落盘

时间、枚举和浮点数看起来都能直接序列化,但跨平台、跨版本后最容易出现时区偏移、枚举错位和精度差异。稳定的存档格式应先定义持久化语义,再决定编码方式,而不是直接照搬语言运行时中的类型表示。

学习目标

  • 为存档中的时间选择明确、跨平台的表示方式
  • 避免枚举成员调整导致旧存档含义改变
  • 根据数据用途决定浮点数是否需要量化或限定精度

时间统一保存为绝对时间

表示“某件事真实发生在什么时候”时,优先保存 UTC Unix 时间戳。它不依赖设备时区,也容易被不同语言解析。毫秒级通常已经足够游戏存档使用,例如 1760000000123 表示 Unix Epoch 之后经过的毫秒数。

如果业务还需要恢复玩家当时看到的本地时间,仅保存时间戳并不够,还应另外保存时区标识。不要只保存 2026-10-08 20:00:00 这种没有时区的信息,因为换设备后无法判断它属于哪个时区。

枚举不要依赖声明顺序

很多语言会默认给枚举成员分配从 0 开始的整数值。如果把这个隐式整数直接写进存档,后来在枚举中间插入一个成员,旧数字就可能被解释成新的含义。

更安全的方案有两种:使用显式且永不复用的数值编码,或者保存稳定字符串编码。对于可读性要求较高、成员数量较少的存档,字符串通常更容易调试和迁移。

csharp
using System;

public enum Difficulty
{
    Easy,
    Normal,
    Hard
}

public static class DifficultyCodec
{
    public static string Encode(Difficulty value) => value switch
    {
        Difficulty.Easy => "easy",
        Difficulty.Normal => "normal",
        Difficulty.Hard => "hard",
        _ => throw new ArgumentOutOfRangeException(nameof(value))
    };

    public static Difficulty Decode(string code) => code switch
    {
        "easy" => Difficulty.Easy,
        "normal" => Difficulty.Normal,
        "hard" => Difficulty.Hard,
        _ => Difficulty.Normal // 未知旧值或未来值使用明确的降级策略
    };
}

public static class Program
{
    public static void Main()
    {
        string stored = DifficultyCodec.Encode(Difficulty.Hard);
        Difficulty restored = DifficultyCodec.Decode(stored);

        Console.WriteLine(stored);
        Console.WriteLine(restored);
    }
}

预期输出:

text
hard
Hard

即使以后调整 Difficulty 的声明顺序,存档里的 hard 仍然保持原来的业务含义。若使用整数编码,也应显式固定每个数字并保证废弃值永不分配给其他成员。

浮点数先看用途再决定精度

浮点数不适合假设“序列化再反序列化后一定能按十进制完全相等”。角色坐标、速度、动画参数等本来就是近似量,通常保存 IEEE 754 float 或 double 的正常序列化结果即可,但比较时应允许误差。

如果数据要求确定的离散精度,例如经验倍率只允许千分之一,可以在落盘前量化成整数。假设倍率为 1.275,保存 1275,读取后再除以 1000.0。金币、库存数量等本来就是整数的数据更不应使用浮点数。

数据 推荐表示 原因
世界事件发生时间 UTC Unix 毫秒 跨时区、跨平台
游戏内持续时间 整数毫秒或 Tick 不受日期与时区影响
枚举状态 稳定字符串或显式整数码 避免版本调整导致错位
角色坐标 float/double 本身允许近似值
固定三位小数的倍率 整数量化值 精度规则明确且可重复

把持久化规则写进数据模型

下面的 JSON 展示一种跨平台存档表示。它是数据结构示例,不依赖某个特定游戏引擎:

json
{
  "savedAtUnixMs": 1760000000123,
  "difficulty": "hard",
  "experienceRateMilli": 1275,
  "positionX": 12.5
}

experienceRateMilli 明确约定为“倍率乘以 1000 后的整数”,因此 1275 恢复为 1.275。positionX 则允许采用普通浮点表示,因为位置数据通常不需要十进制完全一致。

验证存档格式时,应检查同一份数据在目标平台上能恢复相同的业务含义,而不是只比较文本是否逐字一致。真正稳定的协议来自明确的单位、时区、枚举编码和精度约定;这些规则一旦进入已发布存档,就应通过版本迁移修改,而不是静默改变含义。

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

目录与阅读设置

阅读设置

17

记录一个想法

时间、枚举和浮点数怎么落盘

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

登录哪都通