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

平台存档目录应该从哪里取

平台存档目录应该从哪里取

存档系统最容易踩的路径坑,不是文件名怎么拼,而是把开发机上的可写目录误当成所有平台都能写。本节建立统一规则:业务层不猜路径,只向平台或引擎取得持久化目录,再在这个目录下面组织自己的存档文件。

学习目标

  • 区分程序安装目录、临时目录和持久化可写目录
  • 理解 Windows、移动端和主机平台为什么不能共用硬编码路径
  • 将平台路径差异收口到一个存档路径入口

不要从程序所在目录推导存档位置

桌面开发时,经常能看到类似 game.exe、资源文件和配置文件位于同一个目录,于是自然地写出“程序目录 + saves”。这在开发环境可能正常,在正式环境却并不可靠。

Windows 程序可能安装到受保护目录;Android 和 iOS 应用运行在沙盒中;主机平台通常还会通过平台存储机制管理用户存档。程序能读取自己的安装资源,不代表它有权在安装位置创建文件。

因此存档根目录应满足两个条件:应用有写权限,并且生命周期符合“重新启动后仍保留”的要求。缓存目录、临时目录即使可写,也不应拿来保存正式进度。

路径来源 适合正式存档 原因
程序安装目录 否 可能只读或受系统保护
当前工作目录 否 启动方式不同会改变,且权限不可控
临时或缓存目录 否 系统可能主动清理
平台提供的持久化应用目录 是 权限和生命周期由平台保证
主机平台官方存档服务或容器 是 通常还负责用户身份、配额和同步

把平台差异交给平台层

业务代码真正需要知道的只有“存档根目录在哪里”,不应知道 Android 沙盒目录叫什么,也不应拼接某个 Windows 用户目录。路径解析应集中在平台适配层,再把结果交给存档仓库。

不同平台统一映射到存档根目录

以 Unity 为例,桌面端和移动端通常可以通过 Application.persistentDataPath 取得应用的持久化目录,再用 Path.Combine 生成自己的存档路径。下面示例把目录创建和路径拼接集中在一个类中。

csharp
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)}");
    }
}

预期输出中的实际目录会随平台、应用标识和安装环境变化,因此这里只用占位符表示:

text
Save root: <PATH>/saves
Slot path: <PATH>/saves/slot-01.json

验证重点不是路径长什么样,而是应用重新启动后仍能访问该目录,并且可以在其中创建、读取和替换文件。

主机平台不要假设存在普通文件路径

主机平台经常把存档与登录用户、存储配额、云同步、挂载和提交操作绑定在一起。即使引擎暴露了统一接口,底层语义也可能不是“给我一个目录,然后随便 File.WriteAllText”。

因此跨平台设计最好把能力抽象成“打开存档、写入、提交、读取”,而不是让整个业务层依赖一个绝对路径。桌面和移动端的实现可以落到普通文件系统;主机版本则可以替换为对应平台 SDK 或引擎提供的主机存档接口。

路径内部也要保持可迁移

取得正确根目录后,自己的目录结构仍应使用相对层级,例如 saves/slot-01.json、saves/index.json,而不是把绝对路径写进存档数据。这样应用迁移、重新安装或平台切换时,存档内容不会依赖旧设备上的目录名称。

路径拼接也应使用 Path.Combine 这类平台 API,而不是手工写 / 或 \\。统一入口最终应该返回“当前平台可用的存档位置”,业务层只处理槽位、文件版本和序列化内容,这样平台差异才不会扩散到整个存档系统。

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

目录与阅读设置

阅读设置

17

记录一个想法

平台存档目录应该从哪里取

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

登录哪都通