Go语言不提供多级存储抽象标准机制，需自定义读写分离、带context、错误归一的五方法接口（存/取/删/查存在/元信息），禁用只读io/fs.FS，强调路径标准化与错误映射一致性。
Go 语言本身不提供“多级存储抽象”的标准库机制，所谓多级存储（如内存 → 本地磁盘 → 对象存储 → 归档存储）的抽象，是业务架构层的设计问题，不是语言特性。你要掌握的不是 Go 怎么“支持多级存储”，而是怎么用 Go 的接口、错误处理、路径标准化和 context 控制能力，把不同层级的存储行为统一建模、安全切换、可测可控。
为什么不能直接用 io/fs.FS 做通用存储抽象
因为 io/fs.FS 是只读契约，没有 WriteFile、Delete、MkdirAll 等写操作能力。常见踩坑点：
- 把
embed.FS或os.DirFS直接传给需要保存配置的函数，运行时 panic 或静默失败 - 自己封装
os.DirFS却漏掉递归创建父目录逻辑，WriteFile("a/b/c.txt")因a/b不存在而报no such file or directory - 返回
fs.FileInfo给调用方，导致 S3 实现必须伪造os.FileInfo，破坏语义一致性
定义最小可行的存储接口：读写分离 + 领域错误
真正要抽象的是五类行为：存、取、删、查存在、读元信息。所有方法必须带 context.Context，由调用方控制超时与取消。
- 读接口示例：
ReadFile(ctx context.Context, path string) ([]byte, error)、Stat(ctx context.Context, path string) (FileStat, error) - 写接口示例：
WriteFile(ctx context.Context, path string, data []byte, perm fs.FileMode) error、Delete(ctx context.Context, path string) error、Exists(ctx context.Context, path string) (bool, error) -
FileStat必须是自定义结构体，含Name()、Size()、IsDir()、ModTime()方法，不能直接暴露fs.FileInfo - 错误必须归一：统一返回
ErrNotFound、ErrPermissionDenied等领域错误，而不是暴露底层的os.PathError或 AWS SDK 错误
让内存实现和磁盘实现共用同一套业务逻辑的关键点
关键不在“都实现同一个 interface”，而在路径处理、并发安全、错误映射三者一致：
立即学习“go语言免费学习笔记（深入）”；
- 路径标准化：无论内存还是磁盘实现，都要对输入
path调用filepath.Clean，否则"./a/../b"在测试中是"b"，线上却变成"./a/../b"导致找不到文件 - 并发安全：内存实现用
sync.RWMutex或sync.Map，磁盘实现虽天然串行，但若封装了缓存层，也需考虑并发写冲突 - 错误映射：内存实现遇到 key 不存在，应返回
ErrNotFound；磁盘实现遇到os.IsNotExist(err)，也要映射为同一错误，否则上层if errors.Is(err, ErrNotFound)会失效
最易被忽略的是路径标准化和错误归一——它们不写在接口定义里，却决定着不同实现能否真的互换。一旦某次 WriteFile 在内存里自动清理了路径，在磁盘里却没清理，测试全过、上线就出错，排查成本远高于初期加一行 path = filepath.Clean(path)。
