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

多个存档槽该怎样组织目录

多个存档槽该怎样组织目录

多个存档槽不是简单地复制几份 save.json。真正需要解决的是:如何稳定定位某个槽位、如何快速展示槽位列表,以及某个槽损坏时怎样避免影响其他槽。本节给出一种“全局索引 + 槽位目录 + 独立数据文件”的组织方式。

学习目标

  • 设计不会因显示名称变化而改变的槽位目录命名规则
  • 使用全局索引快速列出槽位,同时让每个槽保持独立
  • 通过临时文件替换降低写入中断导致存档损坏的风险

槽位 ID 与显示名称必须分离

目录名应使用程序生成的稳定 ID,例如 slot-0001、slot-0002,而不是玩家输入的“最终决战前”或角色名。显示名称可以修改、包含空格或重复,但槽位 ID 应在创建后保持不变。

推荐把文件职责拆开:

路径 作用
saves/index.json 快速列出所有槽位及排序所需摘要
saves/slot-0001/meta.json 当前槽位的详细元数据
saves/slot-0001/data.json 真正的游戏状态
saves/slot-0001/data.bak 可选的上一次成功版本

这种结构允许删除或修复某个槽位,而不会触碰其他槽位。全局索引只保存列表页需要的数据,不要把完整游戏状态复制进去。

多存档槽的目录与索引关系

索引只保存列表页需要的信息

index.json 可以记录稳定槽位 ID、显示名称、最后保存时间和进度摘要。实际时间属于动态值,下面用 <TIME> 表示。

json
{
  "slots": [
    {
      "slotId": "slot-0001",
      "displayName": "森林营地",
      "updatedAt": "<TIME>",
      "playTimeSeconds": 5420
    },
    {
      "slotId": "slot-0002",
      "displayName": "Boss 战前",
      "updatedAt": "<TIME>",
      "playTimeSeconds": 9100
    }
  ]
}

生效行为是:存档选择界面只读取这一份小文件即可展示列表;玩家真正进入某个槽位时,再读取对应目录中的 meta.json 和 data.json。验证时应确认修改槽位显示名称不会导致目录改名,并且删除一个槽位目录不会让其他槽位无法读取。

创建槽位时同步维护目录和索引

下面用 Python 演示最小实现。示例会创建两个槽位目录、分别写入 meta.json 和 data.json,最后原子替换 index.json。os.replace 能避免索引写到一半时直接覆盖旧文件。

python
import json
import os
from pathlib import Path

ROOT = Path("saves")

def write_json_atomic(path: Path, data: dict) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    temp_path = path.with_suffix(path.suffix + ".tmp")

    with temp_path.open("w", encoding="utf-8") as f:
        json.dump(data, f, ensure_ascii=False, indent=2)

    # 同一文件系统内用替换操作提交完整文件。
    os.replace(temp_path, path)

def create_slot(slot_id: str, display_name: str, hp: int) -> dict:
    slot_dir = ROOT / slot_id
    slot_dir.mkdir(parents=True, exist_ok=True)

    write_json_atomic(
        slot_dir / "meta.json",
        {"slotId": slot_id, "displayName": display_name}
    )
    write_json_atomic(
        slot_dir / "data.json",
        {"version": 1, "player": {"hp": hp}}
    )

    return {
        "slotId": slot_id,
        "displayName": display_name
    }

def main() -> None:
    slots = [
        create_slot("slot-0001", "森林营地", 80),
        create_slot("slot-0002", "Boss 战前", 45)
    ]
    write_json_atomic(ROOT / "index.json", {"slots": slots})

    for slot in slots:
        print(f'{slot["slotId"]}: {slot["displayName"]}')

if __name__ == "__main__":
    main()

预期输出:

text
slot-0001: 森林营地
slot-0002: Boss 战前

运行后还应检查 saves/index.json、两个槽位目录以及各自的 meta.json、data.json 是否存在。真实项目中若增加备份文件,也应沿用“先写临时文件,再替换正式文件”的策略。

索引与槽位文件不一致时怎么处理

全局索引属于加速结构,不应成为唯一真相。如果 index.json 里有槽位,但对应目录已经不存在,可以在启动时移除这条索引;如果目录存在而索引缺失,可以扫描合法槽位目录并重建索引。

当一个槽位损坏时,加载器只应把该槽标记为不可用,并优先尝试 data.bak 或明确的恢复流程。通过“稳定槽位 ID、独立目录、轻量索引、原子写入”这四个约束,多存档系统就能在数量增加后仍保持可定位、可恢复和易维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

多个存档槽该怎样组织目录

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

登录哪都通