Go billy 怎么创建临时文件并在测试结束后清理

Go billy 的临时文件不会因为测试函数结束就自动消失。正确做法是调用 Filesystem.TempFile 创建文件，马上记住 Name() 返回的路径，并在测试清理阶段先关闭文件、再调用文件系统的 Remove。这样同一套测试既能跑在 memfs，也能跑在 osfs 上。

项目地址：https://github.com/go-git/go-billy

一、先看清 TempFile 的创建与清理边界

billy.TempFile 接收目录和文件名前缀，返回一个已经打开的 billy.File。dir 传空字符串时使用具体文件系统的默认临时目录；prefix 只用于让生成的名字更容易识别。它保证并发调用不会主动选择同一个文件名，但不会代替调用方删除文件。

因此，拿到文件后要同时保留两个对象：用于读写的文件句柄，以及用于删除的名字。不要只保存句柄并期待 Close 自动删除，也不要在文件仍打开时直接假定所有后端都能安全删除。

二、在测试里创建并写入一个临时文件

下面的辅助函数只依赖 billy 的接口。示例把目录参数留空，适合不关心具体物理目录的测试；如果测试必须限制落盘位置，再把目录换成当前文件系统允许的相对目录。

func newTempFixture(t *testing.T, fs billy.Filesystem) billy.File {
	// TempFile 返回已打开的读写文件，prefix 便于定位测试残留。
	f, err := fs.TempFile("", "go-billy-test-")
	if err != nil {
		t.Fatalf("创建临时文件失败: %v", err)
	}
	if _, err := io.WriteString(f, "fixture-data"); err != nil {
		// 写入失败时先关闭当前句柄，避免失败路径泄漏资源。
		_ = f.Close()
		t.Fatalf("写入临时文件失败: %v", err)
	}
	return f
}

这里故意不在辅助函数里删除文件，因为调用方还要读取它。创建阶段只负责得到可用的 fixture；生命周期归测试函数统一管理，职责更容易复用。

三、用 t.Cleanup 固定 Close 后 Remove 的顺序

把清理注册在文件创建成功之后，测试无论是正常返回、断言失败还是后续调用 t.Fatal，都能执行。关键顺序是先关闭句柄，再删除路径；清理失败不应覆盖主测试失败，但要写入测试日志。

func TestParseFixture(t *testing.T) {
	// memfs.New 也可以替换成 osfs.New，测试逻辑保持不变。
	fs := memfs.New()
	f := newTempFixture(t, fs)
	name := f.Name()

	t.Cleanup(func() {
		// 先关闭读写句柄，再删除文件路径。
		if err := f.Close(); err != nil {
			t.Errorf("关闭临时文件 %q 失败: %v", name, err)
		}
		if err := fs.Remove(name); err != nil {
			t.Errorf("删除临时文件 %q 失败: %v", name, err)
		}
	})

	// 需要从头读取时显式移动游标，避免把写入位置当成读取位置。
	if _, err := f.Seek(0, io.SeekStart); err != nil {
		t.Fatalf("回到文件开头失败: %v", err)
	}
	data, err := io.ReadAll(f)
	if err != nil {
		t.Fatalf("读取 fixture 失败: %v", err)
	}
	if string(data) != "fixture-data" {
		t.Fatalf("fixture 内容不匹配: %q", data)
	}
}

如果希望多个测试共享同一个清理策略，可以把上面的注册逻辑封装成 helper；但不要把 Remove 放在创建函数返回前，否则返回的文件还没有机会被读取。

四、memfs 与 osfs 只改变验证重点

memfs 适合快速测试，因为文件留在内存中；osfs 更接近真实磁盘，能暴露目录权限和路径问题。两者都不改变“调用方负责删除”的规则。清理完成后，可以用 fs.Stat(name) 期待得到不存在错误；不要只检查 Close 没报错就认为文件已经消失。

相关问题

TempFile 会自动删除临时文件吗？

不会。billy 的接口把删除责任交给调用方，所以要显式调用 Remove。

可以只调用 Remove 不 Close 吗？

不建议。先关闭句柄能让不同文件系统后端拥有一致的生命周期，也能更早暴露写入或关闭错误。

为什么清理函数里不直接使用 defer？

可以使用，但 t.Cleanup 更贴合测试生命周期；它会在测试函数返回后统一执行，适合把 fixture 创建与清理绑定在一起。