如何使用Golang在内存中构建虚拟文件系统

fstest.mapfs是只读虚拟文件系统，仅实现fs.fs接口，调用writefile等写操作会panic；适用于静态资源测试，路径须为字面量且不含./前缀，不支持目录遍历和路径标准化。

如何使用golang在内存中构建虚拟文件系统_golang抽象层

直接用 fstest.MapFS 或自定义 fs.FS 实现即可，但必须清楚它只读、不支持写入、路径不能带 ./ 前缀——想存文件或热更新配置？得换接口。

为什么 fstest.MapFS 一写就 panic

fstest.MapFS 是标准库提供的内存虚拟文件系统，专为测试静态资源设计。它实现了 io/fs.FS，但所有方法都只读：没有 WriteFile、没有 Mkdir、Open 返回的 fs.File 是一次性对象。

调用 f, _ := fsys.Open("x.txt"); io.ReadAll(f); io.ReadAll(f) 第二次会 panic —— 因为 fs.File 不支持复用
fs.WalkDir 能遍历，但 fs.DirEntry.IsDir() 在 fstest.MapFS 中永远返回 false（无真实目录结构）
路径必须是字面量，fs.ReadFile(fsys, "./config.json") 失败；正确写法是 "config.json"
它不处理路径标准化："a/../b" 不会被自动转成 "b"，业务里得自己 filepath.Clean

embed.FS 和 fstest.MapFS 的关键区别

两者都是只读内存 FS，但生命周期和构造方式完全不同：

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

embed.FS 在编译期固化，路径必须是 //go:embed 字面量，比如 //go:embed assets/*；运行时不可变
fstest.MapFS 在运行时构造，适合单元测试中动态模拟一组文件，比如 fstest.MapFS{"data.txt": &fstest.MapFile{Data: []byte("hi")}}
两者都不支持 os.Chmod、os.Symlink、os.Getwd 等系统级操作，这些根本不在 io/fs.FS 接口契约内
若需子目录隔离（如只暴露 templates/ 给 HTTP handler），要用 fs.Sub(fsys, "templates")，不是字符串截断

想在内存里真正“存取删”文件？别用 io/fs.FS

io/fs.FS 是只读抽象，不是存储层。需要写入能力时，必须定义自己的接口，例如：

type FileStore interface {
    ReadFile(ctx context.Context, path string) ([]byte, 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)
    Stat(ctx context.Context, path string) (FileStat, error)
}

内存实现可用 sync.Map 存 path → []byte，但要注意 WriteFile("a/b/c.txt") 需手动解析并创建父目录逻辑
路径必须统一 filepath.Clean，否则 "./a/../b" 在内存实现中是 "b"，在磁盘实现中却是 "./a/../b"，测试通过线上出错
错误不能返回 os.PathError，应归一为 ErrNotFound、ErrPermissionDenied 等领域错误
所有方法必须带 context.Context，由调用方控制超时，不要内部硬编码 context.WithTimeout

什么时候该用 afero.NewMemMapFs 而不是 fstest.MapFS

当你的测试逻辑涉及 Create、MkdirAll、RemoveAll、Chmod 等写操作时，fstest.MapFS 直接不适用。

afero.NewMemMapFs() 是完整可写内存文件系统，行为接近 os，支持递归创建目录、重命名、权限修改
它不兼容 io/fs.FS，所以不能传给 fs.ReadFile；要用 afero.ReadFile(fs, path) 这类配套函数
初始化后所有操作都在内存，fs.Create("a/b/c.txt") 不会生成真实路径，defer os.RemoveAll 完全不需要
注意：它默认不自动建父目录，WriteFile("a/b/c.txt", ...) 仍会因 a/b/ 不存在而失败，得先 fs.MkdirAll("a/b", 0755)

真正容易被忽略的是：接口抽象不是为了“看起来统一”，而是为了路径处理、错误语义、并发模型三者一致。哪怕你只用内存实现做测试，如果没对路径做 filepath.Clean、没把 os.IsNotExist 归一为 ErrNotFound、没在 WriteFile 里补 MkdirAll，上线切到磁盘实现时大概率崩在第一行。