游戏客户端架构 / 系统课时
多个存档槽该怎样组织目录
多个存档槽该怎样组织目录
多个存档槽不是简单地复制几份 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> 表示。
{
"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 能避免索引写到一半时直接覆盖旧文件。
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()预期输出:
slot-0001: 森林营地
slot-0002: Boss 战前运行后还应检查 saves/index.json、两个槽位目录以及各自的 meta.json、data.json 是否存在。真实项目中若增加备份文件,也应沿用“先写临时文件,再替换正式文件”的策略。
索引与槽位文件不一致时怎么处理
全局索引属于加速结构,不应成为唯一真相。如果 index.json 里有槽位,但对应目录已经不存在,可以在启动时移除这条索引;如果目录存在而索引缺失,可以扫描合法槽位目录并重建索引。
当一个槽位损坏时,加载器只应把该槽标记为不可用,并优先尝试 data.bak 或明确的恢复流程。通过“稳定槽位 ID、独立目录、轻量索引、原子写入”这四个约束,多存档系统就能在数量增加后仍保持可定位、可恢复和易维护。