fstest.mapfs 是 go 语言中用于测试文件 io 操作的内存虚拟文件系统，通过 map 存储路径与文件内容，避免真实文件读写。1. 它支持创建虚拟文件和目录结构，如 “hello.txt” 或 “dir1/”；2. 可模拟文件属性，如权限 mode 和修改时间 modtime；3. 能用于单元测试中验证文件读取逻辑，无需依赖真实磁盘；4. 可结合 embed.fs 测试内嵌资源加载逻辑。
在 Go 项目中，测试文件 IO 操作时常常需要避免直接读写真实文件系统。这不仅会拖慢测试速度，还可能导致副作用或依赖外部环境。Go 标准库中的 testing/fstest 提供了一个轻量级的虚拟文件系统实现，非常适合用来模拟文件结构进行单元测试。
什么是 fstest.MapFS
fstest.MapFS 是 testing/fstest 包的核心类型之一，它是一个基于内存的文件系统实现，使用 map 来保存文件路径和内容。你可以把它理解为一个“假”的文件系统，只存在于内存中，不会对磁盘造成任何影响。
比如：
立即学习“go语言免费学习笔记（深入）”；
fs := fstest.MapFS{ "hello.txt": {Data: []byte("hello world")}, }
这样就创建了一个包含 hello.txt 文件的虚拟文件系统，文件内容是 “hello world”。
如何用 fstest 测试文件读取操作
如果你有一个函数是用来读取指定路径下的文件内容的，比如：
func ReadFileContent(fs fs.FS, path string) ([]byte, error) { return fs.ReadFile(path) }
你可以传入 MapFS 实例作为参数，进行测试：
func TestReadFileContent(t *testing.T) { fsys := fstest.MapFS{ "test.txt": {Data: []byte("some content")}, } content, err := ReadFileContent(fsys, "test.txt") if err != nil { t.Fatal(err) } if string(content) != "some content" { t.Fail() } }
这种方式让你可以完全控制输入数据，而且不需要创建真实文件，也更容易做边界测试，比如测试不存在的文件、空文件等。
支持嵌套目录结构和多种文件属性
fstest.MapFS 不仅能模拟普通文件，还可以模拟目录结构，甚至设置文件权限、修改时间等元信息。
例如：
fs := fstest.MapFS{ "dir1/": {Mode: os.ModeDir}, "dir1/file1.txt": {Data: []byte("file1")}, "dir2/file2.json": {Data: []byte(`{"name":"test"}`)}, "empty_file.txt": {Data: []byte("")}, "readme.md": {Data: []byte("# README"), Mode: 0644}, }
上面的例子中：
- 使用 / 结尾表示这是一个目录。
- 可以设置 Mode（权限）和 ModTime（修改时间）。
- 这些设置会影响像 os.FileInfo 的行为，从而更贴近真实场景。
配合 embed.FS 做更复杂的测试（可选）
虽然 fstest.MapFS 主要用于构造测试数据，但你也可以结合 embed.FS 在测试中验证是否正确地加载了内嵌资源。比如：
//go:embed testdata/* var testdata embed.FS func TestLoadEmbeddedFiles(t *testing.T) { // 将 embed.FS 转换为 fs.FS 接口 subFS, err := fs.Sub(testdata, "testdata") if err != nil { t.Fatal(err) } content, _ := ReadFileContent(subFS, "example.txt") // 继续断言 }
这种组合方式适合测试那些需要访问内嵌静态资源的代码逻辑。
基本上就这些。fstest 的设计简洁又实用，特别适合隔离文件 IO 相关的测试逻辑。只要注意构造好虚拟文件结构，再配合接口抽象（如 fs.FS），就能写出稳定、快速的单元测试。
