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 实例作为参数，进行测试：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
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），就能写出稳定、快速的单元测试。
