go单元测试需遵循命名规范（_test.go、testxxx）、善用t.run隔离子测试、通过接口抽象依赖实现安全mock、用可控time.time等替代全局函数，并避免sleep依赖超时。
Go 的单元测试不需要额外框架，go test 命令和 testing 包原生支持，但写得“对”比写得“有”难得多——尤其在 mock、并发、定时器、HTTP 依赖等场景下，容易测了等于没测。
如何命名和组织测试文件与函数
Go 要求测试文件必须以 _test.go 结尾，且和被测代码在同一包内（不推荐放在 internal/testutil 这类独立包里做“通用断言”）。测试函数名必须是 TestXxx 格式（首字母大写 + 驼峰），Xxx 不能是小写字母开头。
常见错误现象：func testAdd() {} 不会被 go test 执行；add_test.go 放在其他包下导致无法访问未导出字段或函数。
- 被测函数是
CalculateTotal，测试函数就叫TestCalculateTotal，别缩写成TestCalc - 一个文件里可以有多个
TestXxx函数，按功能分组，比如TestCalculateTotal_WithNegativeInput和TestCalculateTotal_WithZeroItems - 不要为每个方法都硬凑一个测试函数；优先覆盖边界条件、错误路径、状态变更逻辑
如何正确使用 t.Run 做子测试
t.Run 不只是让输出更清晰，它能隔离 defer、panic、并发 goroutine 和测试上下文（比如 t.Parallel()）。不用它，多个 case 共享变量容易互相污染。
使用场景：同一函数有多个输入组合，或需要复用 setup/teardown 逻辑。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
func TestParseConfig(t *testing.T) {
tests := []struct {
name string
input string
wantErr bool
}{
{"empty", "", true},
{"valid", `host: "localhost"`, false},
}
for _, tt := range tests {
tt := tt // 必须显式重声明，否则闭包里所有 tt.name 都是最后一个值
t.Run(tt.name, func(t *testing.T) {
_, err := ParseConfig([]byte(tt.input))
if (err != nil) != tt.wantErr {
t.Fatalf("ParseConfig() error = %v, wantErr %v", err, tt.wantErr)
}
})
}
}
- 子测试名建议用描述性字符串，避免数字序号（如
"case1"） - 循环中必须写
tt := tt，这是 Go 测试最常踩的坑之一 - 子测试内不要再调
t.Parallel()——t.Run已隐含并发能力，重复调可能触发 panic
如何安全地 mock 外部依赖（DB、HTTP、time）
Go 没有“自动 mock 框架”，强行 patch 函数或全局变量（比如用 monkey）会让测试脆弱、难调试、不兼容 go tip。正确做法是：把依赖抽象为接口，测试时传入 fake 实现。
典型错误：直接在测试里改 http.DefaultClient 或重写 time.Now 函数指针——这会影响其他并行测试，且无法精准控制返回时机。
- HTTP 客户端：定义
HTTPDoer接口，生产代码用*http.Client（它实现了Do方法），测试用httptest.Server或自定义RoundTripfake - 数据库操作：把
*sql.DB封装进DataStore接口，测试时用内存 map 或sqlmock（仅限 SQL 构建逻辑验证，不替代集成测试） - 时间相关逻辑：不要调
time.Now()，改为接收func() time.Time参数，默认传time.Now，测试时传固定时间
如何处理带 context、goroutine 或 timer 的函数
这类函数容易因超时、竞态、提前 cancel 导致测试 flaky（偶尔失败）。关键不是“等久一点”，而是控制执行流。
常见错误现象：time.Sleep(100 * time.Millisecond) 在 CI 上仍失败；select { case 让测试变慢且不可靠。
- 用
context.WithTimeout替代裸time.After，并在测试中主动 cancel 或缩短 timeout - 启动 goroutine 的函数，应在测试中提供同步机制（如
chan struct{}或sync.WaitGroup），而不是靠 sleep 猜它是否结束 - 涉及
time.Timer或time.Ticker的，把它们抽成可注入的接口，测试时用clock.NewMock()（来自github.com/benbjohnson/clock）精确控制时间推进
真正难的不是写完一个 TestXxx，而是让每个测试都具备确定性、快速反馈、不依赖环境——这要求从函数设计阶段就考虑可测试性，比如减少全局状态、拆分纯函数逻辑、明确依赖边界。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
