最简可用go单元测试需满足四点：测试文件名以_test.go结尾、函数名以test开头且参数为*testing.t、与被测代码同包同目录、用t.run实现表格驱动并避免闭包陷阱。
怎么写一个最简可用的 Go 单元测试
Go 的单元测试不需要额外框架，testing 包原生支持，但必须遵守命名和位置约定，否则 go test 根本不会发现你的测试文件。
- 测试文件名必须以
_test.go结尾，比如calculator_test.go - 测试函数名必须以
Test开头，且首字母大写，参数固定为*testing.T，例如func TestAdd(t *testing.T) - 测试文件要和被测代码放在同一包、同一目录下（不能在
main包里测其他包的私有函数）
漏掉任意一条，go test 就会静默跳过——不是失败，是根本没运行，这是新手卡住最多的地方。
如何测带依赖的函数（比如 HTTP 调用或数据库）
硬编码调用真实服务会让测试变慢、不稳定、难并行。Go 推荐用接口抽象 + 依赖注入，而不是 mock 工具。
- 把外部依赖定义成接口（如
type HTTPClient interface { Do(*http.Request) (*http.Response, error) }） - 被测函数接收该接口作为参数，而非直接用
http.DefaultClient - 测试时传入一个实现了该接口的结构体，内部只返回预设数据（即“fake”）
这样做比用第三方 mock 库更轻量，也避免了因 mock 行为和真实实现不一致导致的漏测。注意：别在 fake 实现里做复杂逻辑，它只是个数据桩。
go test -race 能发现什么，又为什么经常报错却找不到源头
竞态检测器（race detector）只对实际发生了并发读写的变量报错，但它不告诉你哪段代码“可能”出问题，只报告“这里确实发生了冲突”。所以常见现象是：错误堆栈指向 runtime.go 或测试框架内部，而非你自己的函数。
- 确保所有共享变量（尤其是全局变量、结构体字段、切片底层数组）在 goroutine 间访问时加锁或用 channel 同步
- 避免在测试中用
time.Sleep等待 goroutine，改用sync.WaitGroup或chan struct{}显式同步 -
-race会显著拖慢执行速度，CI 中建议只对关键模块开启，本地开发可配合go test -v -race ./...快速定位
很多人以为加了 mutex.Lock() 就安全了，结果忘了在所有分支（包括 defer 和 error 返回路径）都 unlock，race 检测器恰恰会抓住这种遗漏。
表格驱动测试怎么组织才不容易崩
用 slice of struct 写测试用例很常见，但容易在错误信息里丢失上下文，一挂全挂，排查成本高。
- 每个测试子项用
t.Run()包裹，名称体现输入特征，比如t.Run("empty_slice", func(t *testing.T) { ... }) - case struct 里显式存
name string字段，别靠索引推断 - 别在循环里直接用闭包捕获循环变量（
for _, c := range cases { t.Run(c.name, func(t *testing.T) { use(c) }) }），Go 1.22 前会全部引用最后一个c，必须写成for _, c := range cases { c := c; t.Run(...) }
表格驱动本身不难，难的是让失败输出能立刻告诉你“是哪个 case、哪一行、预期/实际差在哪”。t.Errorf 里带上 c.name 和具体字段比对，比只写 "got %v, want %v" 强十倍。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
