直接mock os.OpenFile不行，因其是不可赋值的包级函数；应封装文件操作为接口依赖，测试时用bytes.Buffer等内存实现替代。
为什么直接 mock os.OpenFile 不行
Go 标准库的 os.OpenFile 是函数，不是接口方法，无法被直接替换或打桩。硬写 os.OpenFile = func(...) {...} 会编译失败——它在包级作用域是不可赋值的。常见错误是试图在测试里“重写”这个函数，结果报 cannot assign to os.OpenFile。
真正可行的路径是：把文件操作封装进结构体，依赖接口（如 io.Writer 或自定义的 FileWriter 接口），再在测试中传入内存实现（比如 bytes.Buffer 或 memfile）。
- 不要在业务逻辑里直接调用
os.OpenFile、os.WriteFile - 把写入逻辑抽成方法，接收一个
io.Writer参数（或包装它的接口） - 生产代码传
*os.File，测试代码传*bytes.Buffer或io.Discard
用 bytes.Buffer 替代文件写入做断言
这是最轻量、最可控的方案。你不需要创建真实文件、也不用清理临时目录，所有写入内容都留在内存里，可直接用 buf.String() 或 buf.Bytes() 断言。
示例场景：你有一个函数 WriteConfig(w io.Writer, cfg Config) error，它把结构体序列化为 JSON 写入 w：
立即学习“go语言免费学习笔记（深入）”；
func TestWriteConfig(t *testing.T) {
buf := &bytes.Buffer{}
cfg := Config{Port: 8080, Host: "localhost"}
err := WriteConfig(buf, cfg)
if err != nil {
t.Fatal(err)
}
got := buf.String()
if !strings.Contains(got, `"Port":8080`) {
t.Errorf("expected Port field, got %s", got)
}
}
-
bytes.Buffer实现了io.Writer，无需额外适配 - 注意：如果函数内部还做了
file.Sync()或file.Close()，bytes.Buffer不支持，这时得换自定义接口 - 避免用
t.Log(buf.String())调试后忘记删——输出可能污染 CI 日志
当必须测 *os.File 行为时，用 tempfile + os.Remove
极少数情况（比如测试权限、锁、原子写、O_SYNC 标志），你确实需要操作真实文件。这时必须用 os.CreateTemp 创建临时文件，并确保无论成功失败都清理。
别用 /tmp/test.txt 这种固定路径——并发测试会冲突，CI 环境也可能无写权限。
- 用
os.CreateTemp("", "test-*.json")创建唯一路径 - 用
defer os.Remove(path)清理，但要在os.OpenFile成功后才 defer（否则路径未定义） - 记得检查返回的
*os.File是否为nil，再 defer.Close() - Windows 下路径分隔符不用管，
os.TempDir()和os.CreateTemp已处理好
漏掉 os.Remove 或 file.Close() 会导致测试间污染，尤其在 Windows 上文件被占用无法覆盖。
避免在测试里碰 os.Stdout / os.Stderr
有些模块会直接往 os.Stdout 写日志或状态，导致测试输出混乱、断言失败。这不是“写入文件”的本意，但常被混在一起测。
正确做法：把输出目标抽成字段，例如：
type Logger struct {
out io.Writer
}
func (l *Logger) Println(v ...interface{}) {
fmt.Fprintln(l.out, v...)
}
- 测试时传
&bytes.Buffer{}，断言日志内容 - 不建议用
os.Pipe()拦截 stdout——复杂且易死锁 - 如果第三方库硬编码了
os.Stdout，考虑用golang.org/x/exp/slog的Handler替换，或改用支持 writer 注入的日志库（如zerolog）
真实文件写入路径、权限、并发安全这些点，光靠内存 buffer 测不出来；但 90% 的逻辑校验，bytes.Buffer 就够了——别一上来就碰磁盘。
