Go afero 怎么用 MemMapFs 为文件读取测试准备目录

用 afero.NewMemMapFs() 新建内存文件系统，先通过它的 MkdirAll 准备父目录，再用 afero.WriteFile 写入样例文件。把同一个实例传给读取函数，测试就不必依赖项目目录中预先放好的文件。

官方地址：https://github.com/spf13/afero

我更倾向于把目录作为测试输入来构造：目录叫什么、文件有哪些、缺少什么，都留在用例代码中。本文讨论依赖替换，不是某次版本发布；个人建议也不代表已经执行过示例。

先把文件系统变成参数

函数内部若仍调用os.ReadFile，测试创建的内存文件不会参与读取。应接收afero.Fs，并使用afero.ReadFile(storage, name)。生产调用可传入afero.NewOsFs()，测试调用传入MemMapFs，文本处理逻辑保持一致。

每个测试用独立实例准备目录

下面以fixtures/drafts/note.txt为输入。filepath.Join组合路径，filepath.Dir得到父目录，准备与读取使用同一个storage。将示例保存为项目包内的fixture_test.go；这是示例写法，不是已运行结果。

package fixture

import (
    "errors"
    "io/fs"
    "path/filepath"
    "strings"
    "testing"
    "github.com/spf13/afero"
)

// 业务函数只访问注入的文件系统，不直接访问真实磁盘。
func LoadNote(storage afero.Fs, name string) (string, error) {
    data, err := afero.ReadFile(storage, name)
    if err != nil { return "", err }
    return strings.TrimSpace(string(data)), nil
}

func TestLoadNote(t *testing.T) {
    t.Parallel()
    // 每个用例新建实例，防止相同路径造成测试污染。
    storage := afero.NewMemMapFs()
    name := filepath.Join("fixtures", "drafts", "note.txt")
    if err := storage.MkdirAll(filepath.Dir(name), 0755); err != nil {
        t.Fatalf("prepare directory: %v", err)
    }
    // 先准备父目录，再写文件；两者必须使用相同storage。
    if err := afero.WriteFile(storage, name, []byte("  blue sky\n"), 0644); err != nil {
        t.Fatalf("prepare file: %v", err)
    }
    got, err := LoadNote(storage, name)
    if err != nil { t.Fatalf("load note: %v", err) }
    if got != "blue sky" { t.Fatalf("got %q, want blue sky", got) }
}

func TestLoadNoteMissing(t *testing.T) {
    // 缺文件用例持有独立的空文件系统。
    storage := afero.NewMemMapFs()
    _, err := LoadNote(storage, filepath.Join("fixtures", "missing.txt"))
    if !errors.Is(err, fs.ErrNotExist) {
        t.Fatalf("got %v, want not-exist", err)
    }
}

目录或文件准备失败时立即终止该用例，否则后续业务断言只会掩盖夹具错误。缺文件用例不需要写入任何文件，它明确表达空目录环境中的读取行为。

# 在已有Go module内添加依赖，然后运行当前包的测试
go get github.com/spf13/afero
go test .

迁移旧测试时只替换文件依赖

我的建议是先改一个读取函数的依赖入口，再迁移它的一组测试，不要同时修改解析规则、路径约定和错误处理。否则失败时难以判断是哪一项修改带来的变化。

最小测试关注内容与缺失两种输入

正常用例判断去掉首尾空白后的内容，缺文件用例判断fs.ErrNotExist。这覆盖的是业务函数面对两种输入的行为，不表示内存后端能覆盖真实磁盘的一切特性。

涉及操作系统权限、符号链接或平台相关行为时，仍应保留真实临时目录上的集成测试。内存夹具也占进程内存，宜准备恰好够用的小数据，不搬入完整生产文件。

相关问题

为什么写入后仍读不到？

比较准备和读取时的实例、路径，并检查业务代码是否仍直接调用os包。

WriteFile会替我准备父目录吗？

不要把目录准备隐含在文件写入中。示例先显式调用MkdirAll，再处理写入错误。

测试结束要删除磁盘目录吗？

本文示例没有创建真实磁盘目录。内存实例由局部变量持有，不应长久保存到全局变量中。

参考资料：项目说明与API文档。