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

保存一次游戏状态要经过哪些步骤

保存一次游戏状态要经过哪些步骤

一次可靠保存不是“把对象写进文件”这么简单。为了避免崩溃、断电或磁盘写入失败把正式存档破坏掉,保存流程应拆成状态采集、序列化、写入临时文件、刷盘和原子替换几个阶段,并且只有最后替换成功后才算真正完成。

学习目标

  • 理解一次可靠保存从内存状态到正式文件的完整链路。
  • 用临时文件加原子替换避免半写文件覆盖旧存档。
  • 知道每个阶段失败时应该保留什么、回滚什么。

先冻结本次要保存的状态

保存开始时,不要让序列化逻辑直接遍历一个持续变化的游戏世界。更稳妥的方式是先采集本次保存所需的稳定快照,例如玩家属性、任务进度、背包和世界状态。

快照并不一定要求暂停整个游戏。常见做法是在主线程把需要保存的数据复制到独立 DTO,再把序列化和文件 I/O 交给后台线程。这样既避免读到一半时数据发生变化,也能减少卡顿。

采集阶段如果失败,正式存档还没有被碰触,因此可以直接终止本次保存。

序列化后先写临时文件

拿到快照后,把它序列化为 JSON、二进制或其他格式。关键点不是具体格式,而是不要直接覆盖正式文件。如果程序在写到一半时崩溃,原文件可能只剩半份内容。

可靠流程可以概括为“旧档始终保留到新档完全写好为止”。

可靠存档写入流程

临时文件最好与正式文件位于同一目录,例如正式文件是 save-slot-1.json,临时文件可以是 .save-slot-1.json.tmp。这样后面的替换操作更容易保持在同一文件系统内。

最小可运行实现

下面的 Python 示例演示“写临时文件 -> 刷新用户态缓冲 -> fsync -> os.replace”的核心流程。os.replace 在目标存在时会替换它;在同一文件系统内,它通常用于实现原子替换。

python
import json
import os
from pathlib import Path

def save_json_atomic(path: Path, payload: dict) -> None:
    temp_path = path.with_name(f".{path.name}.tmp")

    # 先完整写入临时文件,正式存档在此阶段保持不变。
    with temp_path.open("w", encoding="utf-8") as file:
        json.dump(payload, file, ensure_ascii=False, separators=(",", ":"))
        file.flush()
        os.fsync(file.fileno())

    # 只有临时文件写成功后,才一次性替换正式文件。
    os.replace(temp_path, path)

def main() -> None:
    save_path = Path("save-slot-1.json")
    state = {
        "meta": {"schemaVersion": 1, "slotId": "slot-01"},
        "data": {"level": 8, "gold": 120}
    }

    save_json_atomic(save_path, state)
    print(save_path.read_text(encoding="utf-8"))

if __name__ == "__main__":
    main()

预期输出:

text
{"meta":{"schemaVersion":1,"slotId":"slot-01"},"data":{"level":8,"gold":120}}

运行后,目录中应存在 save-slot-1.json,而临时文件在成功替换后消失。实际文件系统、操作系统和异常时机不同,临时文件也可能在失败后残留,因此启动时可以加入清理或恢复策略。

为什么 flush 和 fsync 不是一回事

flush() 主要把语言运行时的用户态缓冲提交给操作系统;fsync() 则请求操作系统把文件内容同步到持久化存储。两者都不能让所有硬件和文件系统场景绝对免于断电损坏,但比“写完就立刻替换”更稳妥。

还要注意,文件内容落盘与目录项落盘是两件事。在强调掉电一致性的桌面或服务器场景中,POSIX 系统常会在替换后再同步目录;跨平台游戏项目则需要结合引擎、目标平台和文件系统能力设计,而不是假设某个 API 在所有平台上都提供相同耐久性。

失败时应该留下什么

保存流程的核心验收标准不是“异常永远不会发生”,而是“异常发生后至少还有一份可用存档”。因此各阶段的处理应围绕旧正式文件展开。

序列化失败时,不创建或不替换正式文件;临时文件写失败时,删除不完整临时文件并保留旧档;替换失败时,旧档通常仍应保持可读,并把失败原因记录到日志。只有替换成功后,才更新界面上的“最后保存时间”或向玩家显示“保存成功”。

如果还需要进一步提高容错能力,可以在原子替换之外增加上一版备份,例如 save-slot-1.bak。但备份是第二层保护,不能代替临时文件加原子替换这个基本写入流程。

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

目录与阅读设置

阅读设置

17

记录一个想法

保存一次游戏状态要经过哪些步骤

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

登录哪都通