go测试需严格遵守命名约定:文件名以_test.go结尾、函数名以test开头且首字母大写;使用t.run组织子测试并注入依赖避免外部调用,确保可重现与并行执行。

Go 的 testing 包开箱即用,不需要额外安装,但必须遵守命名和结构约定,否则 go test 命令根本不会发现你的测试函数。
测试文件和函数名必须以 _test.go 和 TestXxx 形式命名
Go 只识别两种测试相关约定:
- 文件名必须以
_test.go结尾(如calculator_test.go),且与被测代码在同一个包下(通常同目录) - 测试函数必须是导出的、无参数、无返回值,且以
Test开头,后接大写字母(如TestAdd,不能是testAdd或Test_add) - 如果写成
func testAdd(t *testing.T),go test会静默忽略——不报错也不运行
使用 t.Run 进行子测试能清晰组织多组用例
单个测试函数里验证多个输入输出时,不用反复写 if !ok { t.Fatal(...) },而是用 t.Run 隔离每组数据,失败时能直接看到是哪组 case 出问题:
func TestParseURL(t *testing.T) {
tests := []struct {
name string
input string
wantHost string
}{
{"empty", "", ""},
{"normal", "https://example.com/path", "example.com"},
{"no-scheme", "example.com", ""},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
u, err := url.Parse(tt.input)
if err != nil {
t.Fatal(err)
}
if got := u.Host; got != tt.wantHost {
t.Errorf("Host = %v, want %v", got, tt.wantHost)
}
})
}
}
注意:t.Run 内部的 t 是新实例,不能跨子测试共享状态;子测试名(tt.name)应具备可读性,避免用数字编号。
立即学习“go语言免费学习笔记(深入)”;
避免在测试中依赖全局状态或外部服务
真实项目中常见错误:测试函数里直接调用 http.Get、读写本地文件、修改全局变量。这会导致:
- 测试不可重现(网络超时、文件权限、并发冲突)
- 无法并行执行(
go test -p=4会出错) - CI 环境失败率升高
正确做法是注入依赖:把 HTTP 客户端、数据库连接等作为参数传入被测函数,测试时传入 mock 实现。例如,不要写:
func FetchData() (string, error) {
resp, _ := http.Get("https://api.example.com/data") // ❌ 硬编码 URL,无法控制
// ...
}
而应改为:
func FetchData(client *http.Client, url string) (string, error) { // ✅ 可替换依赖
resp, err := client.Get(url)
// ...
}
测试时传入 &http.Client{Transport: &mockRoundTripper{}} 或使用 httptest.Server 启一个临时服务。
最容易被忽略的是测试覆盖率统计的边界:go test -cover 只统计被实际执行到的代码行,哪怕你写了 TestXxx,如果它没被 go test 扫描到(比如文件名不对),覆盖率就会漏掉整块逻辑——先确保名字对,再谈写得全不全。










