唯一可靠的做法是直接 mock 文件系统操作而非调用真实函数，因其可规避路径权限、并发冲突、临时文件残留、跨平台差异及 ci 权限等不可控变量，并通过接口抽象（如 filereader）和依赖注入实现可控测试。
直接 mock 文件系统操作，而不是调用 os.Open、ioutil.ReadFile 或 os.Stat 等真实函数——这是唯一可靠的做法。
为什么不能在测试里直接操作真实文件
真实文件操作会引入不可控变量：路径权限、并发写入冲突、临时文件残留、Windows/macOS 行为差异、CI 环境无权访问磁盘。哪怕加了 defer os.Remove，也解决不了竞态和清理失败问题。
- 同一测试多次运行可能因残留文件导致结果不一致
-
os.TempDir()在不同平台返回路径格式不同（如\vs/），影响路径拼接逻辑 - 测试失败后临时文件没删干净，下次运行直接 panic
用接口抽象文件操作并注入 mock 实现
核心是把依赖从具体函数抽成接口，让测试能控制返回值。比如读取配置文件的函数：
type FileReader interface {
ReadFile(name string) ([]byte, error)
}
func LoadConfig(r FileReader, path string) (map[string]string, error) {
data, err := r.ReadFile(path)
if err != nil {
return nil, err
}
// 解析 logic...
}
测试时传入一个结构体实现该接口：
type mockReader struct {
data []byte
err error
}
func (m mockReader) ReadFile(_ string) ([]byte, error) {
return m.data, m.err
}
func TestLoadConfig(t *testing.T) {
t.Run("success", func(t *testing.T) {
r := mockReader{data: []byte(`{"key":"value"}`), err: nil}
cfg, err := LoadConfig(r, "config.json")
if err != nil {
t.Fatal(err)
}
if len(cfg) == 0 {
t.Error("expected non-empty config")
}
})
t.Run("file not found", func(t *testing.T) {
r := mockReader{err: os.ErrNotExist}
_, err := LoadConfig(r, "missing.json")
if !errors.Is(err, os.ErrNotExist) {
t.Errorf("expected os.ErrNotExist, got %v", err)
}
})
}
避免手动构造路径字符串，改用 filepath.Join 和接口隔离
硬编码路径（如 "./testdata/config.json"）会让测试在不同工作目录下失败；用 filepath.Join 只是缓解，不是根治。真正要解决的是：路径组装逻辑本身是否该被测？如果业务逻辑里混着路径拼接，就该把它拆出来单独测，而主流程只接收已组装好的 string 或 io.ReadCloser。
- 不要在测试中用
os.Getwd()拼路径——它返回的是执行go test时的当前目录，不是包所在目录 - 若必须读真实测试文件（极少数情况，如验证 JSON Schema），用
filepath.Dir(runtime.FuncForPC(reflect.ValueOf(fn).Pointer()).File())获取测试文件所在目录，再filepath.Join(dir, "testdata", "file.json") - 更推荐：把测试数据内联为字符串或
embed.FS（Go 1.16+），彻底摆脱路径依赖
对 os.Stat、os.MkdirAll 等副作用操作做行为断言
这些函数不返回数据，但改变状态。mock 时需记录调用次数和参数，验证是否按预期执行：
type mockFS struct {
statCalls []string
mkdirCalls []string
}
func (m *mockFS) Stat(name string) (os.FileInfo, error) {
m.statCalls = append(m.statCalls, name)
return nil, os.ErrNotExist
}
func (m *mockFS) MkdirAll(path string, perm os.FileMode) error {
m.mkdirCalls = append(m.mkdirCalls, path)
return nil
}
func TestEnsureDir(t *testing.T) {
fs := &mockFS{}
EnsureDir(fs, "/tmp/logs") // 假设这是你要测的函数
if len(fs.mkdirCalls) != 1 || fs.mkdirCalls[0] != "/tmp/logs" {
t.Errorf("expected mkdirAll called once with /tmp/logs, got %+v", fs.mkdirCalls)
}
}
注意：别在 mock 里做真实 IO，否则又绕回原点。
最易被忽略的一点：所有文件系统相关逻辑，只要暴露给外部（比如作为包导出函数），就必须通过接口抽象——不是“将来可能要测才加”，而是“只要用了 os 就立刻抽”。否则某天加个新测试，就会发现根本没法解耦。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
