测试夹具文件应放在名为testdata的子目录中,该目录须小写、无点、不以_test.go结尾;文件命名需语义化,如testdata/users.json,避免无意义名称。

测试夹具文件该放在哪,命名有什么讲究
Go 的测试夹具(test fixtures)没有强制目录规范,但社区普遍把它们放在 testdata/ 目录下,和对应测试文件同级或在包根目录。这个路径不会被 go build 打包,但 go test 可以正常读取——关键在于它必须是小写、不含点、不以 _test.go 结尾的普通目录。
文件命名建议带语义:比如 testdata/users.json、testdata/orders.yaml,避免用 fixture1.txt 这类无意义名。如果数据需区分场景,可加前缀如 testdata/users_valid.json 和 testdata/users_empty.json。
用 ioutil.ReadFile 还是 os.ReadFile 加载 fixture
Go 1.16+ 应该用 os.ReadFile,它比已弃用的 ioutil.ReadFile 更轻量,且不依赖额外导入。注意路径拼接别硬写字符串,要用 filepath.Join 处理跨平台分隔符:
data, err := os.ReadFile(filepath.Join("testdata", "users.json"))
if err != nil {
t.Fatal(err)
}
常见错误是直接写 "testdata/users.json" 然后在子目录运行测试失败——因为 os.ReadFile 的路径是相对于当前工作目录(os.Getwd()),不是测试文件所在目录。稳妥做法是在测试函数开头用 t.TempDir() 或固定从 filepath.Dir(runtime.Caller(0).File) 推导基路径,但对 fixture 来说,更简单的是统一约定:所有测试都从模块根目录运行(即 go test ./...),并确保 testdata/ 在那里。
立即学习“go语言免费学习笔记(深入)”;
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
批量加载 JSON/YAML fixture 到结构体切片
如果 fixture 是数组格式(如 [{"id":1,"name":"a"},{"id":2,"name":"b"}]),直接 json.Unmarshal 到 []User 即可;但如果存的是多行 JSON(NDJSON)或多个独立 YAML 文档,就得逐段解析。
- JSON 数组:用
json.Unmarshal(data, &users),users类型为[]User - NDJSON(每行一个对象):用
bufio.Scanner按行读,每行json.Unmarshal - YAML 多文档:用
yaml.YAMLOptions{KnownFields: true}(Go 1.22+)或第三方库如gopkg.in/yaml.v3的yaml.UnmarshalAll
性能上,单次 Unmarshal 数组最快;NDJSON 内存友好但解析稍慢;YAML 多文档易读但解析开销略高。别忘了在测试里加 t.Parallel() 前确保 fixture 数据不被并发修改——通常只读,所以安全。
测试结束后要不要清理数据库或状态
如果夹具用于初始化内存态服务(如 map、in-memory cache),不用清理;但若写入了真实数据库、文件或网络服务,必须清理,否则测试会污染彼此。
推荐用 defer + 显式清理函数,而不是依赖 t.Cleanup——后者在 panic 时可能不执行:
db := setupTestDB(t)
defer func() { teardownTestDB(t, db) }() // 确保 panic 也触发
// 加载 fixture
err := loadUsersFromFixture(db, "testdata/users.json")
if err != nil {
t.Fatal(err)
}
容易忽略的点:清理逻辑本身可能失败(比如 DB 连接已断),这时应记录日志但不 t.Fatal,否则掩盖原始测试失败。另外,SQLite 测试常用 :memory: 数据库,这种不用清理,但要注意每个测试得新建连接,否则事务隔离失效。

















