Go测试文件须命名为_test.go且与源码同包；测试函数需以Test开头、接收testing.T参数；推荐表驱动测试和t.Run子测试，注意资源隔离与错误传播。
Go test 文件命名和位置必须严格匹配
Go 的 go test 命令只识别以 _test.go 结尾的文件，且必须与被测代码在同一个包（目录）下。常见错误是把测试文件放到 test/ 子目录或命名为 mytest.go，导致 go test 完全不执行它。
- 正确命名：
calculator.go对应的测试文件是calculator_test.go - 测试文件中包声明通常为
package calculator（与源码同包），除非你明确要测导出行为（此时可用package calculator_test，但需确保所有被测符号已导出） - 不要在测试文件里写
func main()，go test会自行构建并运行测试函数
测试函数必须以 Test 开头且接收 *testing.T 参数
Go 测试框架只运行签名符合 func TestXxx(*testing.T) 的函数（Xxx 首字母大写）。名字不能含下划线、不能是 Test 或 Test_ 这类非法形式，否则会被忽略。
func TestAdd(t *testing.T) {
result := Add(2, 3)
if result != 5 {
t.Errorf("expected 5, got %d", result)
}
}
-
t.Fatal和t.Fatalf会立即终止当前测试函数；t.Error/t.Errorf记录错误但继续执行，适合批量校验 - 避免在测试中使用
log.Fatal或os.Exit，它们会让整个go test进程退出，跳过其余测试 - 子测试可用
t.Run("name", func(t *testing.T) { ... })组织，便于隔离和过滤（如go test -run=TestAdd/divide_by_zero）
表驱动测试是 Go 单元测试的默认实践
硬编码多组输入输出容易让测试函数臃肿、难以维护。Go 社区普遍采用结构体切片定义测试用例，配合循环执行，大幅提升可读性和覆盖效率。
func TestParseURL(t *testing.T) {
tests := []struct {
name string
input string
wantHost string
wantErr bool
}{
{"valid", "https://example.com/path", "example.com", false},
{"no-scheme", "example.com", "", true},
{"empty", "", "", true},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
host, err := ParseURL(tt.input)
if (err != nil) != tt.wantErr {
t.Fatalf("ParseURL(%q) error = %v, wantErr %v", tt.input, err, tt.wantErr)
}
if !tt.wantErr && host != tt.wantHost {
t.Errorf("ParseURL(%q) = %q, want %q", tt.input, host, tt.wantHost)
}
})
}
}
- 每个测试项的
name字段建议具名，方便定位失败用例（t.Run(tt.name, ...)） - 如果某个字段需要深度比较（如结构体、map），用
reflect.DeepEqual而非==，但注意它无法处理函数、unsafe.Pointer 等类型 - 避免在测试数据里放复杂初始化逻辑；用例数据应尽量静态、轻量
测试依赖和并发需显式控制
Go 测试默认并发执行所有顶层 TestXxx 函数（但同一 TestXxx 内部不并发）。若测试涉及共享资源（如全局变量、临时文件、数据库连接），必须手动同步或重置状态。
立即学习“go语言免费学习笔记（深入）”；
- 用
t.Parallel()显式声明测试可并发 —— 但仅当它不依赖任何共享状态时才安全 - 修改全局变量（如
http.DefaultClient）后，务必在测试末尾恢复原值，或使用局部变量替代 - 涉及时间的操作（如
time.Now()）应通过可注入的接口或函数参数解耦，测试中传入固定时间值 - 临时文件推荐用
t.TempDir()（Go 1.16+），它会在测试结束自动清理，比os.MkdirTemp+defer os.RemoveAll更可靠
t.Run 内部调用 t.Fatal，只终止该子测试，外层循环仍继续；而忘记加 t.Run 又会导致用例名丢失、无法单独运行。这两点在调试失败时特别影响效率。 
