游戏客户端架构 / 系统课时
保存一次游戏状态要经过哪些步骤
保存一次游戏状态要经过哪些步骤
一次可靠保存不是“把对象写进文件”这么简单。为了避免崩溃、断电或磁盘写入失败把正式存档破坏掉,保存流程应拆成状态采集、序列化、写入临时文件、刷盘和原子替换几个阶段,并且只有最后替换成功后才算真正完成。
学习目标
- 理解一次可靠保存从内存状态到正式文件的完整链路。
- 用临时文件加原子替换避免半写文件覆盖旧存档。
- 知道每个阶段失败时应该保留什么、回滚什么。
先冻结本次要保存的状态
保存开始时,不要让序列化逻辑直接遍历一个持续变化的游戏世界。更稳妥的方式是先采集本次保存所需的稳定快照,例如玩家属性、任务进度、背包和世界状态。
快照并不一定要求暂停整个游戏。常见做法是在主线程把需要保存的数据复制到独立 DTO,再把序列化和文件 I/O 交给后台线程。这样既避免读到一半时数据发生变化,也能减少卡顿。
采集阶段如果失败,正式存档还没有被碰触,因此可以直接终止本次保存。
序列化后先写临时文件
拿到快照后,把它序列化为 JSON、二进制或其他格式。关键点不是具体格式,而是不要直接覆盖正式文件。如果程序在写到一半时崩溃,原文件可能只剩半份内容。
可靠流程可以概括为“旧档始终保留到新档完全写好为止”。

临时文件最好与正式文件位于同一目录,例如正式文件是 save-slot-1.json,临时文件可以是 .save-slot-1.json.tmp。这样后面的替换操作更容易保持在同一文件系统内。
最小可运行实现
下面的 Python 示例演示“写临时文件 -> 刷新用户态缓冲 -> fsync -> os.replace”的核心流程。os.replace 在目标存在时会替换它;在同一文件系统内,它通常用于实现原子替换。
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()预期输出:
{"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。但备份是第二层保护,不能代替临时文件加原子替换这个基本写入流程。