测试文件读写时不能直接操作真实磁盘，因存在残留、并发冲突、权限等问题；应使用 os.CreateTemp + defer os.Remove 或 fstest.MapFS 进行隔离。
测试文件读写时为什么不能直接操作真实磁盘
因为真实文件系统有副作用：写入后残留、并发冲突、权限问题、CI 环境无写入权限，甚至误删生产文件。Go 测试必须隔离 I/O，否则 os.Open 或 ioutil.ReadFile（已弃用）在测试中调用会不可靠。
核心原则是：用内存模拟文件系统，或用临时目录 + 自动清理。
- 优先使用
os.CreateTemp创建带随机名的临时文件，测试完立刻os.Remove - 避免硬编码路径如
"./test.txt"，它在不同工作目录下会失败 - 不要依赖
ioutil.ReadFile—— 它在 Go 1.16+ 已被移到io.ReadFile，且不处理错误细节，不利于断言
用 os.CreateTemp 和 defer os.Remove 写可重复的测试
这是最轻量、兼容性最好的方式，不需要引入第三方库，适用于所有 Go 版本 ≥ 1.16。
func TestReadWriteFile(t *testing.T) {
tmpfile, err := os.CreateTemp("", "test-*.txt")
if err != nil {
t.Fatal(err)
}
defer os.Remove(tmpfile.Name()) // 确保清理
content := []byte("hello world")
if _, err := tmpfile.Write(content); err != nil {
t.Fatal(err)
}
tmpfile.Close()
// 重新打开读取
data, err := os.ReadFile(tmpfile.Name())
if err != nil {
t.Fatal(err)
}
if !bytes.Equal(data, content) {
t.Errorf("expected %s, got %s", content, data)
}}
立即学习“go语言免费学习笔记（深入）”；
注意：defer os.Remove 必须在 tmpfile.Close() 之后，否则 Windows 下会报 “The process cannot access the file because it is being used by another process”。
用 io/fs + fstest.MapFS 模拟整个文件系统（Go 1.16+）
当你的函数接收 fs.FS 参数（比如封装了 embed.FS 或需要跨平台抽象），或者要测多文件交互逻辑（如遍历目录、读多个配置），fstest.MapFS 是更干净的选择。
它把文件内容存在内存 map 中，完全无磁盘 I/O，启动快、可预测、线程安全。
func TestWithMapFS(t *testing.T) {
fsys := fstest.MapFS{
"config.json": &fstest.MapFile{Data: []byte(`{"mode":"dev"}`)},
"readme.md": &fstest.MapFile{Data: []byte("# hello")},
}
data, err := fs.ReadFile(fsys, "config.json")
if err != nil {
t.Fatal(err)
}
if string(data) != `{"mode":"dev"}` {
t.Error("unexpected content")
}}
立即学习“go语言免费学习笔记（深入）”；
限制：不能用于测试 os.OpenFile 的 flag（如 os.O_APPEND），因为 MapFS 只支持只读操作；也不支持 os.Stat 返回真实 modtime —— 它统一返回 Unix 时间戳 0。
常见陷阱和绕过方案
很多测试卡在“文件明明写了却读不到”，原因往往不是代码逻辑，而是 I/O 同步或路径问题：
-
os.File.Write不保证立即落盘，但测试中通常不需要file.Sync()—— 因为后续os.ReadFile会重新打开文件，能读到最新内容；只有涉及 mmap 或并发写时才需考虑 - 用
t.TempDir()（Go 1.16+）替代手动生成临时目录，它会在测试结束自动递归删除整个目录，比os.RemoveAll更安全 - 如果函数内部硬编码了
os.Open("data.txt")，测试前无法注入路径 —— 这时候应重构：把文件名作为参数传入，或接受io.Reader接口，而不是直接操作文件名
真正难测的从来不是“怎么读写”，而是“怎么让读写行为变得可替换”。一旦函数耦合了具体文件路径或 *os.File 类型，测试成本就陡增。优先设计成接收接口或路径参数，比事后 mock 文件系统更省力。
