Go testing/fstest.MapFS 怎样读取指定文件并检查路径错误

在测试依赖 io/fs.FS 的代码时，直接读真实磁盘会让测试夹带目录结构和环境状态。testing/fstest.MapFS 提供了一个轻量的内存文件系统：用路径名映射到 MapFile，再通过 ReadFile 或 Open 读取。

这篇只解决一个具体问题：怎样读取 MapFS 里的指定文件，并稳定地区分路径非法、文件不存在和读取成功。关键做法是保留原始错误，用 errors.Is 判断 fs.ErrNotExist，不要依赖错误字符串。

用 MapFS 表达测试文件

MapFS 的键就是传给 Open、ReadFile 等方法的文件系统路径，值是描述文件的 *MapFile。普通文件至少需要提供 Data；如果要显式控制目录元数据，再给目录项设置 fs.ModeDir。

package main

import (
	"fmt"
	"testing/fstest"
)

func main() {
	fsys := fstest.MapFS{
		"config/app.json": &fstest.MapFile{
			// Data 是文件正文；路径使用 io/fs 约定的斜杠。
			Data: []byte(`{"port":8080}`),
		},
	}

	data, err := fsys.ReadFile("config/app.json")
	if err != nil {
		// 读取失败必须保留原始错误，调用方才能继续分类处理。
		panic(err)
	}
	fmt.Println(string(data))
}

这里没有显式写入 config 目录，但 MapFS 可以根据文件键合成需要的父目录。若测试的是空目录，或者需要断言目录的权限和修改时间，就应显式放入一个带 fs.ModeDir 的 MapFile。

用 ReadFile 读取指定路径

如果业务只需要完整文件内容，优先调用 fs.ReadFile(fsys, name) 或 MapFS 的 ReadFile 方法。它把打开、读取和关闭组合在一起，示例更短，也不会把文件句柄生命周期带到测试断言之外。

package main

import (
	"errors"
	"fmt"
	"io/fs"
	"testing/fstest"
)

func loadConfig(fsys fstest.MapFS, name string) ([]byte, error) {
	data, err := fs.ReadFile(fsys, name)
	if err != nil {
		// 让上层拿到 PathError，避免把错误改写成无法判断的普通字符串。
		return nil, err
	}
	return data, nil
}

func main() {
	fsys := fstest.MapFS{
		"config/app.json": &fstest.MapFile{Data: []byte(`{"enabled":true}`)},
	}

	data, err := loadConfig(fsys, "config/app.json")
	if err != nil {
		// errors.Is 可以跨过 PathError 外壳判断底层语义。
		if errors.Is(err, fs.ErrNotExist) {
			fmt.Println("文件不存在")
			return
		}
		fmt.Println("读取失败：", err)
		return
	}
	fmt.Println(string(data))
}

测试函数通常不需要关心 MapFS 的内部 map 遍历，只需要把业务要求的路径传入并检查返回值。要测试目录，则可以调用 fs.ReadDir；要测试流式读取，再改用 fsys.Open 并明确关闭返回的文件。

区分路径非法与文件缺失

MapFS 的读取入口会先按 io/fs 的规则检查路径。像 config\\app.json、../app.json 或包含空路径段的写法都不应当当作普通文件名处理。路径不符合规则时，MapFS 仍会返回带操作名和路径的 *fs.PathError，底层原因通常可用 fs.ErrNotExist 判断。

func classify(fsys fstest.MapFS, name string) string {
	_, err := fs.ReadFile(fsys, name)
	if err == nil {
		return "读取成功"
	}

	var pathErr *fs.PathError
	if errors.As(err, &pathErr) {
		// PathError 保留了 Op、Path 和 Err，适合记录诊断上下文。
		if errors.Is(pathErr.Err, fs.ErrNotExist) {
			return "路径非法或文件不存在"
		}
	}
	return "其他读取错误"
}

实际测试时，建议同时覆盖三组输入：

目录与测试边界要先说清

MapFS 的便利性来自“路径键加内存数据”，但它不是完整的磁盘模拟器。父目录可以按需合成；显式目录则用于控制目录元数据或表示空目录。MapFS 的文件系统操作直接读取 map，因此测试执行期间不要并发修改这张 map，否则会引入数据竞争。

另外，目录打开或目录读取需要遍历整个 map。它更适合小型、确定性的单元测试；如果要模拟成千上万条文件、真实权限、文件锁或操作系统特性，应把这些场景交给更合适的集成测试。

最后，测试断言应优先写成 errors.Is、errors.As 或对 PathError 字段的判断，不要写“错误字符串包含 not exist”。这样既能保留上下文，也能减少 Go 版本或实现细节变化带来的脆弱断言。

常见问题

MapFS 为什么不用手动补齐所有父目录？

对包含子路径的文件，MapFS 可以按需合成父目录。只有需要显式的目录元数据或空目录时，才建议把目录项作为 MapFile 放入 map。

读取不存在文件时应该比较什么？

比较 errors.Is(err, fs.ErrNotExist)。不要直接比较 err.Error()，也不要假设错误一定是某个固定字符串。

什么时候应该用 Open 而不是 ReadFile？

需要流式读取、检查 fs.File.Stat 或模拟文件句柄生命周期时使用 Open；只需要完整字节内容时，ReadFile 更直接。

总结

用 MapFS 测试文件读取时，可以把问题拆成三层：用路径键和 MapFile 建模，用 ReadFile 获取指定内容，用 errors.Is 识别 fs.ErrNotExist。再把显式目录、并发修改和 map 规模写进测试边界，内存文件测试就会既轻量又稳定。