Go 1.16+ 必须使用 os.ReadFile 读取 Golden 文件，ioutil.ReadFile 已弃用且在 Go 1.22+ 中移除；路径需相对测试文件而非项目根目录，禁止硬编码绝对路径或手动拼接 io.ReadAll + os.Open。
Golden File 测试该用 os.ReadFile 还是 ioutil.ReadFile
Go 1.16+ 应该无条件用 os.ReadFile，ioutil.ReadFile 已被弃用且在 Go 1.22+ 中彻底移除。用错会导致构建失败或 CI 突然报错。
实际写法很简单：
golden, err := os.ReadFile("testdata/output.golden")
注意路径必须是相对测试文件（*_test.go）的路径，不是相对项目根目录——这点容易搞混。如果测试文件在 cmd/xxx/xxx_test.go，那 testdata/ 就得放在同级目录下，不是放在 ./testdata/。
- 别用
io.ReadAll+os.Open手动拼，冗余且易漏Close - 别硬编码绝对路径，比如
/tmp/xxx.golden，这会让测试无法跨机器运行 - Golden 文件本身建议用 Unix 换行（LF），避免 Windows 下 git 自动转 CRLF 导致 diff 失败
如何安全更新 Golden 文件而不手误覆盖
不能靠人肉 cp output.txt testdata/output.golden，一不小心就 commit 错版本，或者把调试临时输出当成了新 golden。
立即学习“go语言免费学习笔记（深入）”；
推荐在测试里加一个可开关的「更新模式」：
func TestRenderOutput(t *testing.T) {
want, err := os.ReadFile("testdata/output.golden")
if err != nil {
t.Fatal(err)
}
got := renderSomething() // 实际被测逻辑
if *updateGolden { // 声明全局 flag：var updateGolden = flag.Bool("update", false, "")
if err := os.WriteFile("testdata/output.golden", []byte(got), 0644); err != nil {
t.Fatal(err)
}
return
}
if !bytes.Equal(want, []byte(got)) {
t.Errorf("output mismatch; run with -update to regenerate")
}
}
- 必须用
go test -update触发更新，禁止直接改文件 -
os.WriteFile要设权限0644，否则某些 CI 环境会因权限问题导致后续读取失败 - 更新后立刻 git diff 确认，Golden 文件内容是否真的符合预期——尤其是结构体序列化、时间戳、随机 ID 类字段，得先做归一化再比对
遇到非确定性输出（如时间、UUID、内存地址）怎么办
Golden 测试崩就崩在这类字段上。不能让 time.Now() 或 uuid.New() 直接进输出，否则每次跑都不一样，diff 永远失败。
核心原则：测试前「冻结」不确定性源，而不是在 golden 里手动删改。
- 对时间：传入固定
time.Time或 mocktime.Now函数变量（如定义var nowFunc = time.Now，测试时替换） - 对 UUID：用
uuid.MustParse("00000000-0000-0000-0000-000000000000")占位，或注入生成器接口 - 对指针/内存地址：避免打印
%p；若日志含&v，改用fmt.Sprintf("%#v", v)或自定义String()方法屏蔽地址
切记：golden 是「期望输出」，不是「原始输出快照」。它得稳定、可重现、有语义。
Golden 文件过大或结构嵌套深时怎么维护
单个 .golden 文件超 500 行，或 JSON/YAML 嵌套超过 4 层，就难定位差异、易引发冲突。这时候要拆，但不是乱拆。
按「语义块」而非「文件大小」拆分：
- HTTP 响应体 →
testdata/response_body.golden - 错误详情（stack trace 截断后）→
testdata/error_detail.golden - CLI help 输出 →
testdata/help_output.golden
每个测试函数只负责一个 golden 文件，避免一个测试读多个文件又搞混顺序。另外，别把 binary 数据（如图片、压缩包）塞进 golden——那是集成测试或 fixture 的事，不是快照测试的职责。
最常被忽略的是：Golden 文件一旦提交，就得像代码一样维护。字段删了？golden 得同步删。格式加了缩进？所有相关 golden 都得批量重生成并 review——没人做这一步，golden 就会悄悄腐烂。
