Go快照测试需手动实现，推荐testify/assert+os.WriteFile自建方案，用cmp.Diff比对结构化数据，快照存testdata/目录下.json格式，-update标志触发更新。
快照测试在 Go 里没有原生支持，得靠第三方库或手动实现
Go 标准库不提供 snapshot testing 能力，不像 Jest 或 Rust 的 insta 那样开箱即用。这意味着你得自己选工具链、定义比对逻辑、处理更新流程，否则容易变成“写一次就扔”的临时断言。
主流做法是用 github.com/google/go-cmp/cmp + 文件 I/O 手动存取快照，或引入轻量库如 github.com/smartystreets/goconvey/convey（不推荐）或更专注的 github.com/rogpeppe/go-internal/testscript（适合 CLI 输出）。但最常用、最可控的是基于 testify/assert + os.WriteFile 的自建方案。
用 cmp.Diff 做结构化快照比对最稳妥
如果你要快照的是 struct、map、slice 等 Go 值（比如 API 响应结构体），别用 fmt.Sprintf 或 json.MarshalIndent 直接序列化——它们对字段顺序、零值、嵌套 nil slice 等行为不一致，容易误报。
-
cmp.Diff能精确识别字段增删、类型变化、指针差异，且支持自定义选项（比如忽略时间戳、忽略 map key 顺序） - 快照文件建议用
.golden后缀，内容为cmp.Equal期望的原始值（非字符串）经fmt.Printf("%#v", v)输出，便于人工核对 - 测试中读取快照文件后，用
gob或json反序列化（推荐json，兼容性好；注意导出字段名必须大写） - 更新快照时不要手改文件，统一用
-updateflag 触发写入，避免遗漏或格式错误
运行时加 -update 参数才能写入新快照
Go 测试本身不识别 -update，你需要自己解析 os.Args 或用 flag 包提前声明。漏掉这步，所有快照写入都会静默失败。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
典型写法：
var update = flag.Bool("update", false, "update .golden files")
func TestAPIResponse(t *testing.T) {
flag.Parse() // 必须在 test 函数开头调用
if *update {
data, _ := json.MarshalIndent(resp, "", " ")
os.WriteFile("testdata/response.golden", data, 0644)
return
}
// ... 读 golden、反序列化、cmp.Diff 比对
}
注意：flag.Parse() 必须在每个测试函数内调用（Go test 不共享 flag 上下文），且不能放在 init() 或包级变量里。
快照路径必须用 testdata/ 子目录，且禁止硬编码绝对路径
Go 的 go test 会把当前测试包路径作为工作目录，所以快照文件路径必须相对包根。常见错误是写成 ./snapshots/xxx.golden 或 /tmp/xxx.golden，导致 CI 失败或本地和 CI 行为不一致。
- 所有快照文件统一放
testdata/目录下（Go 官方约定，go test会自动打包该目录进 test binary） - 读写路径用
filepath.Join("testdata", "xxx.golden")，而非拼接字符串 - CI 环境中，确保
testdata/被 git 跟踪（空目录需放.gitkeep），否则os.ReadFile直接 panic - 如果快照内容含环境敏感字段（如 host、port、timestamp），务必在比对前用
cmpopts.IgnoreFields过滤
快照测试真正的复杂点不在写法，而在维护边界：什么时候该更新快照？谁有权限更新？更新后是否同步通知协作者？这些没法靠代码解决，得靠 PR 检查清单和团队约定。
