Go测试文件必须以\_test.go结尾，Test函数需为TestXxx形式且接收*testing.T；推荐表驱动测试和接口注入mock，避免全局状态。
test 文件名必须以 _test.go 结尾
Go 的测试框架只识别 *_test.go 后缀的文件，其他命名（比如 test_utils.go 或 utils_test.go.bak）不会被 go test 扫描。这个规则硬编码在构建系统里，不满足就直接“静默跳过”——你改了代码、加了断言，但 go test 一行输出都没有，不是没跑，是根本没发现它。
常见踩坑点：
-
utils_test.go✅ 合法 -
utils_test.go.txt❌ 不会被加载 -
test_utils.go❌ Go 不认为这是测试文件 - 同一目录下存在
utils.go和utils_test.go，但后者引用了main包里的未导出变量——会编译失败，因为测试文件属于独立包（utils_test），不能访问utils包的非导出标识符
Test 函数必须是 TestXxx 形式且接收 *testing.T
函数签名必须是 func TestXxx(t *testing.T)，其中 Xxx 首字母大写。Go 测试驱动器靠反射匹配，名字不满足规范（比如 testAdd、Test_add、func Test(t *testing.T)）会导致函数被完全忽略，go test -v 也不会显示它。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
go test -run ^TestAdd$精确运行单个测试，避免名字拼错却误以为逻辑有问题 - 不要在测试函数里用
log.Fatal或os.Exit(1)：这会终止整个测试进程，跳过后续测试；应改用t.Fatal或t.Fatalf，它们只让当前测试失败并继续执行其他测试 - 如果需要并发验证多个分支，用
t.Run做子测试，名字带描述性，比如t.Run("empty_slice", func(t *testing.T) { ... })
表驱动测试（table-driven tests）是 Golang 测试主流写法
比起为每个 case 写一个 TestXxx 函数，把输入、期望、说明组织成结构体切片，再循环调用，更易维护、覆盖全、diff 友好。官方标准库和绝大多数高质量 Go 项目都这么写。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
典型结构示例：
func TestParseDuration(t *testing.T) {
tests := []struct {
name string
input string
want time.Duration
wantErr bool
}{
{"zero", "0s", 0, false},
{"invalid", "123", 0, true},
{"minutes", "5m", 5 * time.Minute, false},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
got, err := ParseDuration(tt.input)
if (err != nil) != tt.wantErr {
t.Errorf("ParseDuration(%q) error = %v, wantErr %v", tt.input, err, tt.wantErr)
return
}
if !tt.wantErr && got != tt.want {
t.Errorf("ParseDuration(%q) = %v, want %v", tt.input, got, tt.want)
}
})
}
}注意点：
-
t.Run内部的t是新实例，可以安全调用t.Parallel()实现并发测试（前提是各 case 无共享状态） - 结构体字段名尽量与实际参数/返回值对齐（如
input/got、want），降低认知负担 - 避免在
tests切片里写复杂表达式（比如time.Now().Add(1 * time.Hour)），容易导致每次运行结果不同，让测试不稳定
Mock 外部依赖时优先用接口 + 组合，而非 monkey patch
Go 没有内置 mock 框架，也不鼓励运行时替换函数（类似 Python 的 patch）。正确做法是把依赖抽象为接口，通过结构体字段或函数参数注入，测试时传入实现了该接口的 fake/stub 类型。
例如，某服务依赖 http.Client 发请求：
- ❌ 错误方式：在测试中修改全局
http.DefaultClient，或用第三方库去 patchhttp.Get - ✅ 正确方式：定义
type HTTPDoer interface { Do(*http.Request) (*http.Response, error) }，原代码接收该接口；测试时传入一个记录调用参数的fakeHTTPClient结构体 - 标准库已提供
http.Client实现该接口，生产代码无需改动；测试代码也无需引入额外依赖
这种设计同时提升了可测试性和可维护性——接口即契约，比“能不能 mock 成功”更能反映代码是否面向组合、职责清晰。
真正难的不是写断言，而是把要测的逻辑从 IO、时间、随机性、全局状态里剥离开。一旦剥离干净，go test 就只是跑纯函数而已。
