游戏客户端架构 / 系统课时
平台存档目录应该从哪里取
平台存档目录应该从哪里取
存档系统最容易踩的路径坑,不是文件名怎么拼,而是把开发机上的可写目录误当成所有平台都能写。本节建立统一规则:业务层不猜路径,只向平台或引擎取得持久化目录,再在这个目录下面组织自己的存档文件。
学习目标
- 区分程序安装目录、临时目录和持久化可写目录
- 理解 Windows、移动端和主机平台为什么不能共用硬编码路径
- 将平台路径差异收口到一个存档路径入口
不要从程序所在目录推导存档位置
桌面开发时,经常能看到类似 game.exe、资源文件和配置文件位于同一个目录,于是自然地写出“程序目录 + saves”。这在开发环境可能正常,在正式环境却并不可靠。
Windows 程序可能安装到受保护目录;Android 和 iOS 应用运行在沙盒中;主机平台通常还会通过平台存储机制管理用户存档。程序能读取自己的安装资源,不代表它有权在安装位置创建文件。
因此存档根目录应满足两个条件:应用有写权限,并且生命周期符合“重新启动后仍保留”的要求。缓存目录、临时目录即使可写,也不应拿来保存正式进度。
| 路径来源 | 适合正式存档 | 原因 |
|---|---|---|
| 程序安装目录 | 否 | 可能只读或受系统保护 |
| 当前工作目录 | 否 | 启动方式不同会改变,且权限不可控 |
| 临时或缓存目录 | 否 | 系统可能主动清理 |
| 平台提供的持久化应用目录 | 是 | 权限和生命周期由平台保证 |
| 主机平台官方存档服务或容器 | 是 | 通常还负责用户身份、配额和同步 |
把平台差异交给平台层
业务代码真正需要知道的只有“存档根目录在哪里”,不应知道 Android 沙盒目录叫什么,也不应拼接某个 Windows 用户目录。路径解析应集中在平台适配层,再把结果交给存档仓库。

以 Unity 为例,桌面端和移动端通常可以通过 Application.persistentDataPath 取得应用的持久化目录,再用 Path.Combine 生成自己的存档路径。下面示例把目录创建和路径拼接集中在一个类中。
using System;
using System.IO;
using UnityEngine;
public static class SavePathProvider
{
public static string GetSaveRoot()
{
// 让 Unity 根据当前运行平台解析持久化可写目录。
string root = Path.Combine(Application.persistentDataPath, "saves");
Directory.CreateDirectory(root);
return root;
}
public static string GetSlotPath(int slot)
{
if (slot < 0)
{
throw new ArgumentOutOfRangeException(nameof(slot));
}
return Path.Combine(GetSaveRoot(), $"slot-{slot:D2}.json");
}
}
public sealed class SavePathDemo : MonoBehaviour
{
private void Start()
{
Debug.Log($"Save root: {SavePathProvider.GetSaveRoot()}");
Debug.Log($"Slot path: {SavePathProvider.GetSlotPath(1)}");
}
}预期输出中的实际目录会随平台、应用标识和安装环境变化,因此这里只用占位符表示:
Save root: <PATH>/saves
Slot path: <PATH>/saves/slot-01.json验证重点不是路径长什么样,而是应用重新启动后仍能访问该目录,并且可以在其中创建、读取和替换文件。
主机平台不要假设存在普通文件路径
主机平台经常把存档与登录用户、存储配额、云同步、挂载和提交操作绑定在一起。即使引擎暴露了统一接口,底层语义也可能不是“给我一个目录,然后随便 File.WriteAllText”。
因此跨平台设计最好把能力抽象成“打开存档、写入、提交、读取”,而不是让整个业务层依赖一个绝对路径。桌面和移动端的实现可以落到普通文件系统;主机版本则可以替换为对应平台 SDK 或引擎提供的主机存档接口。
路径内部也要保持可迁移
取得正确根目录后,自己的目录结构仍应使用相对层级,例如 saves/slot-01.json、saves/index.json,而不是把绝对路径写进存档数据。这样应用迁移、重新安装或平台切换时,存档内容不会依赖旧设备上的目录名称。
路径拼接也应使用 Path.Combine 这类平台 API,而不是手工写 / 或 \\。统一入口最终应该返回“当前平台可用的存档位置”,业务层只处理槽位、文件版本和序列化内容,这样平台差异才不会扩散到整个存档系统。